@adhdev/daemon-core 0.9.82-rc.360 → 0.9.82-rc.361

package/dist/index.mjs

@@ -311,10 +311,10 @@ function readInjected(value) {
 }
 function getDaemonBuildInfo() {
   if (cached) return cached;
-  const commit = readInjected(true ? "ea4a65e3d2be71c4aba09dbb000df08d2111759e" : void 0) ?? "unknown";
-  const commitShort = readInjected(true ? "ea4a65e3" : void 0) ?? (commit !== "unknown" ? commit.slice(0, 7) : "unknown");
-  const version = readInjected(true ? "0.9.82-rc.360" : void 0) ?? readInjected(typeof process !== "undefined" ? process.env?.ADHDEV_PKG_VERSION : void 0) ?? "unknown";
-  const builtAt = readInjected(true ? "2026-06-23T08:23:05.522Z" : void 0);
+  const commit = readInjected(true ? "4c8bb331f13862335f134d8a1b97fa17eaca01e0" : void 0) ?? "unknown";
+  const commitShort = readInjected(true ? "4c8bb331" : void 0) ?? (commit !== "unknown" ? commit.slice(0, 7) : "unknown");
+  const version = readInjected(true ? "0.9.82-rc.361" : void 0) ?? readInjected(typeof process !== "undefined" ? process.env?.ADHDEV_PKG_VERSION : void 0) ?? "unknown";
+  const builtAt = readInjected(true ? "2026-06-23T11:56:37.654Z" : void 0);
   cached = builtAt ? { commit, commitShort, version, builtAt } : { commit, commitShort, version };
   return cached;
 }
@@ -14161,7 +14161,7 @@ function forwardUnresolvedDelegateEvent(components, routing, event) {
 }
 function ackUnresolvedDelegateForwardByFingerprint(coordinatorDaemonId, eventName, payload) {
   const match = peekUnresolvedDelegateForwards().find(
-    (entry) => entry.coordinatorDaemonId === coordinatorDaemonId && readNonEmptyString2(entry.payload.event) === eventName && readNonEmptyString2(entry.payload.targetSessionId || entry.payload.sessionId || entry.payload.instanceId) === readNonEmptyString2(payload.targetSessionId || payload.sessionId || payload.instanceId) && readNonEmptyString2(entry.payload.workspace) === readNonEmptyString2(payload.workspace)
+    (entry) => daemonIdsEquivalent(entry.coordinatorDaemonId, coordinatorDaemonId) && readNonEmptyString2(entry.payload.event) === eventName && readNonEmptyString2(entry.payload.targetSessionId || entry.payload.sessionId || entry.payload.instanceId) === readNonEmptyString2(payload.targetSessionId || payload.sessionId || payload.instanceId) && readNonEmptyString2(entry.payload.workspace) === readNonEmptyString2(payload.workspace)
   );
   if (match) ackUnresolvedDelegateForward(match.id);
 }
@@ -15821,1010 +15821,1599 @@ var init_external_sources = __esm({
   }
 });
 
-// src/cli-adapters/pty-transport.ts
-var pty_transport_exports = {};
-__export(pty_transport_exports, {
-  NodePtyTransportFactory: () => NodePtyTransportFactory
-});
-import * as os13 from "os";
-function loadNodePty() {
-  if (cachedPty !== void 0) return cachedPty;
-  try {
-    cachedPty = __require("node-pty");
-    ensureNodePtySpawnHelperPermissions();
-  } catch {
-    cachedPty = null;
-  }
-  return cachedPty;
+// src/providers/spec/fsm-types.ts
+function isV4Spec(raw) {
+  return !!raw && typeof raw === "object" && raw.$schema === "adhdev:cli/spec@4";
 }
-var cachedPty, NodePtyRuntimeTransport, NodePtyTransportFactory;
-var init_pty_transport = __esm({
-  "src/cli-adapters/pty-transport.ts"() {
-    "use strict";
-    init_spawn_env();
-    init_resolve_executable();
-    NodePtyRuntimeTransport = class {
-      constructor(handle) {
-        this.handle = handle;
-      }
-      ready = Promise.resolve();
-      terminalQueriesHandled = false;
-      get pid() {
-        return this.handle.pid;
-      }
-      write(data) {
-        this.handle.write(data);
-      }
-      resize(cols, rows) {
-        this.handle.resize(cols, rows);
-      }
-      kill() {
-        this.handle.kill();
-      }
-      getMetadata() {
-        return null;
-      }
-      onData(callback) {
-        this.handle.onData(callback);
-      }
-      onExit(callback) {
-        this.handle.onExit(callback);
-      }
-    };
-    NodePtyTransportFactory = class {
-      spawn(command, args, options) {
-        const pty = loadNodePty();
-        if (!pty) throw new Error("node-pty is not installed");
-        let cwd = options.cwd;
-        if (cwd) {
-          try {
-            const fs32 = __require("fs");
-            const stat2 = fs32.statSync(cwd);
-            if (!stat2.isDirectory()) cwd = os13.homedir();
-          } catch {
-            cwd = os13.homedir();
-          }
-        }
-        const handle = pty.spawn(resolveWin32Executable(command), args, {
-          name: "xterm-256color",
-          cols: options.cols,
-          rows: options.rows,
-          cwd,
-          env: options.env
-        });
-        return new NodePtyRuntimeTransport(handle);
-      }
-    };
-  }
-});
-
-// src/providers/sdk/v1/builders/cli/visible-region.ts
-function compile(re, flags) {
-  try {
-    return new RegExp(re, flags ?? "");
-  } catch (e) {
-    throw new Error(`Invalid visible-region anchor regex /${re}/${flags ?? ""}: ${e.message}`);
-  }
+function initialState(spec) {
+  return spec.states.find((s2) => s2.initial) ?? spec.states[0];
 }
-function findAllMatches(re, text) {
-  const results = [];
-  const iter = new RegExp(re.source, re.flags.replace("g", "") + "g");
-  let m;
-  while ((m = iter.exec(text)) !== null) {
-    results.push(m);
-    if (m[0].length === 0) iter.lastIndex += 1;
-  }
-  return results;
+function stateById(spec, id) {
+  return spec.states.find((s2) => s2.id === id);
 }
-function applyVisibleRegion(spec, text) {
-  if (!text) return text;
-  switch (spec.scope) {
-    case "screen":
-    case "buffer":
-      return text;
-    case "tail": {
-      const limit = spec.tailChars ?? 4e3;
-      if (text.length <= limit) return text;
-      return text.slice(-limit);
-    }
-    case "between-anchors": {
-      const anchors = spec.anchors;
-      if (!anchors?.top && !anchors?.bottom) return text;
-      const selectLast = (spec.selectAnchor ?? "first") === "last";
-      let topEnd = 0;
-      if (anchors.top) {
-        const topRe = compile(anchors.top.pattern, anchors.top.flags);
-        const topMatches = findAllMatches(topRe, text);
-        if (topMatches.length === 0) {
-          return text;
-        }
-        const chosen = selectLast ? topMatches[topMatches.length - 1] : topMatches[0];
-        topEnd = chosen.index + chosen[0].length;
-      }
-      let bottomStart = text.length;
-      if (anchors.bottom) {
-        const bottomRe = compile(anchors.bottom.pattern, anchors.bottom.flags);
-        const searchFrom = topEnd;
-        const suffix = text.slice(searchFrom);
-        const bottomMatches = findAllMatches(bottomRe, suffix);
-        if (bottomMatches.length === 0) {
-          return text;
-        }
-        const chosen = selectLast ? bottomMatches[bottomMatches.length - 1] : bottomMatches[0];
-        bottomStart = searchFrom + chosen.index;
-      }
-      if (topEnd >= bottomStart) {
-        return text;
-      }
-      return text.slice(topEnd, bottomStart);
-    }
-    default:
-      return text;
-  }
+function outgoingTransitions(spec, stateId) {
+  const matches = spec.transitions.filter((t) => {
+    if (t.from === "*") return true;
+    if (Array.isArray(t.from)) return t.from.includes(stateId);
+    return t.from === stateId;
+  });
+  return matches.map((t, i) => ({ t, i })).sort((a, b) => (b.t.priority ?? 0) - (a.t.priority ?? 0) || a.i - b.i).map((x) => x.t);
 }
-var init_visible_region = __esm({
-  "src/providers/sdk/v1/builders/cli/visible-region.ts"() {
+function statusForState(state) {
+  if (state.status) return state.status;
+  if (state.modal) return "approval";
+  if (state.id === "busy" || state.id === "generating") return "generating";
+  return "idle";
+}
+function modalKindForState(state) {
+  if (state.modal_kind) return state.modal_kind;
+  if (state.modal) return "approval";
+  return null;
+}
+var init_fsm_types = __esm({
+  "src/providers/spec/fsm-types.ts"() {
     "use strict";
   }
 });
 
-// src/providers/sdk/v1/builders/cli/detect-status.ts
-function compile2(re, flags) {
+// src/providers/spec/fsm-loader.ts
+var fsm_loader_exports = {};
+__export(fsm_loader_exports, {
+  loadFsmSpec: () => loadFsmSpec,
+  validateFsmSpec: () => validateFsmSpec
+});
+import * as fs10 from "fs";
+function loadFsmSpec(sourcePath) {
+  let raw;
   try {
-    return new RegExp(re, flags ?? "");
-  } catch (e) {
-    throw new Error(`Invalid regex /${re}/${flags ?? ""}: ${e.message}`);
+    raw = JSON.parse(fs10.readFileSync(sourcePath, "utf8"));
+  } catch (err) {
+    return { ok: false, errors: [`Failed to read/parse spec: ${err.message}`], sourcePath };
   }
+  const errors = validateFsmSpec(raw);
+  if (errors.length) return { ok: false, errors, sourcePath };
+  return { ok: true, spec: raw, sourcePath };
 }
-function takeTail(text, lines) {
-  if (!text) return "";
-  const split = text.split("\n");
-  if (split.length <= lines) return text;
-  return split.slice(-lines).join("\n");
-}
-function scopeText(input, scope, windowLines) {
-  const lines = windowLines && windowLines > 0 ? windowLines : 8;
-  switch (scope) {
-    case "whole-screen":
-      return input.screenText ?? "";
-    case "recent-buffer":
-      return input.tail ?? "";
-    case "last-n-lines":
-    case "live-frame-tail":
-    case void 0:
-    default:
-      return takeTail(input.screenText ?? "", lines);
+function validateFsmSpec(raw) {
+  const errs = [];
+  if (!isV4Spec(raw)) return ['$schema must be "adhdev:cli/spec@4"'];
+  const spec = raw;
+  if (!spec.id) errs.push("id is required");
+  if (!spec.binary) errs.push("binary is required");
+  if (!spec.send_message?.submit_key) errs.push("send_message.submit_key is required");
+  if (spec.pre_launch_trust !== void 0) {
+    const t = spec.pre_launch_trust;
+    if (!t || typeof t !== "object" || Array.isArray(t)) {
+      errs.push("pre_launch_trust must be an object");
+    } else {
+      if (typeof t.settings_path !== "string" || !t.settings_path) errs.push("pre_launch_trust.settings_path is required");
+      if (typeof t.key !== "string" || !t.key) errs.push("pre_launch_trust.key is required");
+    }
   }
-}
-function compileSpinnerMatchers(spec) {
-  return spec.patterns.map((p) => compile2(p.regex, p.flags ?? "i"));
-}
-function compileSettledPromptMatchers(spec) {
-  const prompt = compile2(spec.regex, spec.flags ?? "m");
-  const footers = (spec.withFooter ?? []).map((f) => {
-    if (f.kind === "regex") {
-      const re = compile2(f.pattern, f.flags ?? "i");
-      return { test: (s2) => re.test(s2) };
+  if (spec.refocus_when_stalled_ms !== void 0) {
+    if (typeof spec.refocus_when_stalled_ms !== "number" || !(spec.refocus_when_stalled_ms > 0)) {
+      errs.push("refocus_when_stalled_ms must be a positive number");
+    } else if (!Array.isArray(spec.send_on_spawn) || spec.send_on_spawn.length === 0) {
+      errs.push("refocus_when_stalled_ms requires send_on_spawn (the wake sequence to re-inject)");
     }
-    const needle = f.pattern.toLowerCase();
-    return { test: (s2) => s2.toLowerCase().includes(needle) };
-  });
-  return { prompt, footers };
-}
-function extractButtonLabels(spec, text) {
-  if (!text) return [];
-  const flags = spec.buttonFlags && spec.buttonFlags.includes("m") ? spec.buttonFlags : `${spec.buttonFlags ?? ""}m`;
-  const buttonRe = compile2(spec.buttonPattern, flags);
-  const labelGroup = Number.isInteger(spec.buttonLabelGroup) && (spec.buttonLabelGroup ?? 0) > 0 ? spec.buttonLabelGroup : 1;
-  const out = [];
-  for (const line of text.split("\n")) {
-    buttonRe.lastIndex = 0;
-    const m = buttonRe.exec(line);
-    if (!m) continue;
-    const captured = m[labelGroup] ?? (labelGroup === 1 && m.length > 2 ? m[m.length - 1] : void 0);
-    if (captured && captured.trim()) out.push(captured.trim());
   }
-  return out;
-}
-function buttonBlockApprovalCue(spec, text) {
-  const labels = extractButtonLabels(spec, text);
-  if (labels.length < 2) return false;
-  if (pickApprovalButton(labels).index < 0) return false;
-  return hasNegativeApprovalOption(labels);
-}
-function modalMatches(spec, input) {
-  const text = input.screenText ?? "";
-  const question = compile2(spec.questionPattern, spec.questionFlags ?? "i");
-  if (question.test(text)) return true;
-  for (const variant of spec.questionVariants ?? []) {
-    const re = compile2(variant.regex, variant.flags ?? "i");
-    if (re.test(text)) return true;
+  if (!Array.isArray(spec.states) || spec.states.length === 0) {
+    errs.push("states[] must be a non-empty array");
+    return errs;
   }
-  if (buttonBlockApprovalCue(spec, text)) return true;
-  return false;
-}
-function evaluateGroup(group, spec, input, compiled) {
-  switch (group) {
-    case "spinner": {
-      if (!spec.spinner || !compiled.spinner) return null;
-      const text = scopeText(input, spec.spinner.scope, spec.spinner.scopeWindowLines);
-      return compiled.spinner.some((re) => re.test(text)) ? "generating" : null;
-    }
-    case "modal": {
-      if (!spec.modal) return null;
-      return modalMatches(spec.modal, input) ? "waiting_approval" : null;
+  if (!Array.isArray(spec.transitions)) {
+    errs.push("transitions[] must be an array");
+    return errs;
+  }
+  const ids = /* @__PURE__ */ new Set();
+  let initialCount = 0;
+  for (const [i, s2] of spec.states.entries()) {
+    if (!s2.id) {
+      errs.push(`states[${i}].id is required`);
+      continue;
     }
-    case "settled-prompt": {
-      if (!spec.settledPrompt || !compiled.settled) return null;
-      const text = scopeText(input, spec.settledPrompt.scope, spec.settledPrompt.scopeWindowLines);
-      if (!compiled.settled.prompt.test(text)) return null;
-      if (compiled.settled.footers.length === 0) return "idle";
-      return compiled.settled.footers.every((f) => f.test(text)) ? "idle" : null;
+    if (ids.has(s2.id)) errs.push(`states[${i}].id "${s2.id}" is duplicated`);
+    ids.add(s2.id);
+    if (!s2.label) errs.push(`states[${i}].label is required`);
+    if (s2.initial) initialCount += 1;
+    if (s2.status && !["idle", "generating", "approval"].includes(s2.status)) {
+      errs.push(`states[${i}].status "${s2.status}" must be idle|generating|approval`);
     }
-    // Groups declared in the catalog but not yet implemented as builder steps
-    // return null so they are no-ops in dispatch — declaring them in `order`
-    // is forward-compatible. Phase 2 Week 8+ will wire them.
-    case "cue-ordering":
-    case "error-detection":
-    case "approval-stitching":
-      return null;
-    default:
-      return null;
   }
-}
-function buildDetectStatusFromTui(spec) {
-  const compiledSpinner = spec.spinner ? compileSpinnerMatchers(spec.spinner) : null;
-  const compiledSettled = spec.settledPrompt ? compileSettledPromptMatchers(spec.settledPrompt) : null;
-  const compiled = { spinner: compiledSpinner, settled: compiledSettled };
-  const order = spec.dispatchOrder?.order && spec.dispatchOrder.order.length > 0 ? spec.dispatchOrder.order : DEFAULT_ORDER;
-  return function detectStatus(input) {
-    const effectiveInput = spec.visibleRegion ? {
-      ...input,
-      screenText: applyVisibleRegion(spec.visibleRegion, input.screenText ?? ""),
-      tail: applyVisibleRegion(spec.visibleRegion, input.tail)
-    } : input;
-    for (const group of order) {
-      const verdict = evaluateGroup(group, spec, effectiveInput, compiled);
-      if (verdict !== null) return verdict;
+  if (initialCount === 0) errs.push("exactly one state must have initial:true (none found)");
+  if (initialCount > 1) errs.push(`exactly one state must have initial:true (${initialCount} found)`);
+  const sectionIds = new Set(Object.keys(spec.sections ?? {}));
+  for (const [i, t] of spec.transitions.entries()) {
+    const froms = t.from === "*" ? [] : Array.isArray(t.from) ? t.from : [t.from];
+    for (const f of froms) {
+      if (!ids.has(f)) errs.push(`transitions[${i}].from references unknown state "${f}"`);
     }
-    return null;
-  };
-}
-var DEFAULT_ORDER;
-var init_detect_status = __esm({
-  "src/providers/sdk/v1/builders/cli/detect-status.ts"() {
-    "use strict";
-    init_visible_region();
-    init_approval_utils();
-    DEFAULT_ORDER = ["spinner", "modal", "settled-prompt"];
+    if (t.from !== "*" && froms.length === 0) errs.push(`transitions[${i}].from is required`);
+    if (!t.to) errs.push(`transitions[${i}].to is required`);
+    else if (!ids.has(t.to)) errs.push(`transitions[${i}].to references unknown state "${t.to}"`);
+    if (t.when) errs.push(...validateCondition(t.when, sectionIds, `transitions[${i}].when`));
   }
-});
-
-// src/providers/sdk/v1/builders/cli/parse-approval.ts
-function compile3(re, flags) {
-  try {
-    return new RegExp(re, flags);
-  } catch (e) {
-    throw new Error(`Invalid regex /${re}/${flags ?? ""}: ${e.message}`);
+  for (const [i, s2] of spec.states.entries()) {
+    const sec = s2.extract?.title?.section;
+    if (sec && !sectionIds.has(sec)) errs.push(`states[${i}].extract.title.section "${sec}" unknown`);
+    const bsec = s2.extract?.buttons?.section;
+    if (bsec && !sectionIds.has(bsec)) errs.push(`states[${i}].extract.buttons.section "${bsec}" unknown`);
   }
+  return errs;
 }
-function findQuestionLineIndex(spec, lines) {
-  const primary = compile3(spec.questionPattern, spec.questionFlags ?? "i");
-  for (let i = lines.length - 1; i >= 0; i -= 1) {
-    if (primary.test(lines[i])) return { index: i, matchedSource: "primary" };
-  }
-  for (const variant of spec.questionVariants ?? []) {
-    const re = compile3(variant.regex, variant.flags ?? "i");
-    for (let i = lines.length - 1; i >= 0; i -= 1) {
-      if (re.test(lines[i])) return { index: i, matchedSource: variant.label ?? "variant" };
-    }
+function validateCondition(c, sectionIds, path42) {
+  const errs = [];
+  const w = c;
+  if ("all" in w) {
+    w.all.forEach((x, i) => errs.push(...validateCondition(x, sectionIds, `${path42}.all[${i}]`)));
+    return errs;
   }
-  return null;
-}
-function scopeLines(spec, lines, questionIndex) {
-  const scope = spec.scope ?? "between-last-two-separators";
-  if (scope === "whole-screen") {
-    return { start: 0, end: lines.length };
+  if ("any" in w) {
+    w.any.forEach((x, i) => errs.push(...validateCondition(x, sectionIds, `${path42}.any[${i}]`)));
+    return errs;
   }
-  if (scope === "window-around-question") {
-    const window = spec.scopeWindowLines ?? 16;
-    return {
-      start: Math.max(0, questionIndex - 2),
-      end: Math.min(lines.length, questionIndex + window)
-    };
+  if ("not" in w) {
+    errs.push(...validateCondition(w.not, sectionIds, `${path42}.not`));
+    return errs;
   }
-  let lastSep = -1;
-  let prevSep = -1;
-  for (let i = lines.length - 1; i >= 0; i -= 1) {
-    if (SEPARATOR_RE.test(lines[i].trim())) {
-      if (lastSep < 0) lastSep = i;
-      else if (prevSep < 0) {
-        prevSep = i;
-        break;
-      }
+  if ("matches" in w) {
+    if (w.section && !sectionIds.has(w.section)) errs.push(`${path42}.section "${w.section}" unknown`);
+    try {
+      new RegExp(w.matches, w.flags ?? "i");
+    } catch (e) {
+      errs.push(`${path42}.matches invalid regex: ${e.message}`);
     }
+    return errs;
   }
-  if (lastSep >= 0 && prevSep >= 0) {
-    return { start: prevSep, end: lastSep + 1 };
-  }
-  return {
-    start: Math.max(0, questionIndex - 4),
-    end: Math.min(lines.length, questionIndex + 16)
-  };
-}
-function extractButtons(spec, lines, windowStart, windowEnd) {
-  const buttonRe = compile3(spec.buttonPattern, spec.buttonFlags ?? "m");
-  const out = [];
-  const labelGroup = Number.isInteger(spec.buttonLabelGroup) && (spec.buttonLabelGroup ?? 0) > 0 ? spec.buttonLabelGroup : 1;
-  let i = windowStart;
-  while (i < windowEnd) {
-    const line = lines[i];
-    const m = buttonRe.exec(line);
-    const captured = m?.[labelGroup] ?? (labelGroup === 1 && m && m.length > 2 ? m[m.length - 1] : void 0);
-    if (m && captured) {
-      let label = captured.trim();
-      if (spec.continuationLines) {
-        let j = i + 1;
-        while (j < windowEnd) {
-          const next = lines[j];
-          if (!next.trim()) break;
-          if (buttonRe.test(next)) break;
-          if (!/^\s+/.test(next)) break;
-          label += " " + next.trim();
-          j += 1;
-        }
-        i = j;
-      } else {
-        i += 1;
-      }
-      out.push(label);
-    } else {
-      i += 1;
-    }
+  if ("cursor_above" in w && "changed" in w) return errs;
+  if ("elapsed_ms" in w) {
+    if (typeof w.elapsed_ms !== "number") errs.push(`${path42}.elapsed_ms must be a number`);
+    return errs;
   }
-  return out;
-}
-function buildMessage(spec, lines, questionIndex, windowStart, windowEnd) {
-  const messageParts = [];
-  if (spec.contextHeader) {
-    const ctxRe = compile3(spec.contextHeader.regex, (spec.contextHeader.flags ?? "i") + "m");
-    const haystack = lines.slice(windowStart, windowEnd).join("\n");
-    const m = ctxRe.exec(haystack);
-    if (m) messageParts.push(m[1] ? m[1].trim() : m[0].trim());
+  if ("stable_ms" in w) {
+    if (typeof w.stable_ms !== "number") errs.push(`${path42}.stable_ms must be a number`);
+    return errs;
   }
-  messageParts.push(lines[questionIndex].trim());
-  return messageParts.filter(Boolean).join(" \u2014 ");
+  errs.push(`${path42} is not a recognized condition`);
+  return errs;
 }
-function extractInlineButtons(spec, lines, windowStart, windowEnd) {
-  if (!spec.inlineButtonPattern) return [];
-  const declaredFlags = spec.inlineButtonFlags ?? "gi";
-  const flags = declaredFlags.includes("g") ? declaredFlags : declaredFlags + "g";
-  const re = compile3(spec.inlineButtonPattern, flags);
-  const out = [];
-  for (let i = windowStart; i < windowEnd; i += 1) {
-    let m;
-    re.lastIndex = 0;
-    while ((m = re.exec(lines[i])) !== null) {
-      const label = (m[1] ?? m[0]).trim();
-      if (label && !out.includes(label)) out.push(label);
-      if (m.index === re.lastIndex) re.lastIndex += 1;
-    }
+var init_fsm_loader = __esm({
+  "src/providers/spec/fsm-loader.ts"() {
+    "use strict";
+    init_fsm_types();
   }
-  return out;
+});
+
+// src/providers/spec/evaluator.ts
+var evaluator_exports = {};
+__export(evaluator_exports, {
+  evaluateCondition: () => evaluateCondition,
+  extractButtonsFromRule: () => extractButtonsFromRule,
+  extractTitle: () => extractTitle,
+  lastContiguousNumberedBlock: () => lastContiguousNumberedBlock,
+  resolveSections: () => resolveSections,
+  sectionText: () => sectionText
+});
+function resolveSize(size, total) {
+  if (size === void 0) return 0;
+  if (typeof size === "number") return Math.max(0, Math.min(total, size));
+  const m = /^(\d+(?:\.\d+)?)%$/.exec(size);
+  if (!m) return 0;
+  const pct = Number(m[1]);
+  return Math.max(0, Math.min(total, Math.round(total * pct / 100)));
 }
-function buildParseApprovalFromTui(spec, visibleRegion) {
-  const minButtons = spec.minButtons ?? 2;
-  return function parseApproval(input) {
-    const rawText = input.screenText ?? input.buffer ?? "";
-    if (!rawText) return null;
-    const text = visibleRegion ? applyVisibleRegion(visibleRegion, rawText) : rawText;
-    const lines = text.split("\n");
-    const question = findQuestionLineIndex(spec, lines);
-    if (!question) return null;
-    const { start, end } = scopeLines(spec, lines, question.index);
-    if (question.index < start || question.index >= end) return null;
-    let buttons = extractButtons(spec, lines, question.index + 1, end);
-    if (buttons.length < minButtons && spec.inlineButtonPattern) {
-      buttons = extractInlineButtons(spec, lines, question.index, end);
+function resolveSections(sectionsObj, lines) {
+  const total = lines.length;
+  const anchored = /* @__PURE__ */ new Map();
+  const sectionEntries = Object.entries(sectionsObj);
+  for (const [id, sec] of sectionEntries) {
+    let from = 0;
+    let to = total;
+    if (sec.anchor !== void 0) {
+      try {
+        const anchorPatterns = Array.isArray(sec.anchor) ? sec.anchor : [sec.anchor];
+        const sharedCtx = Array.isArray(sec.anchor_context) ? null : sec.anchor_context ?? null;
+        const ctxList = Array.isArray(sec.anchor_context) ? sec.anchor_context : anchorPatterns.map(() => sharedCtx);
+        const candidates = anchorPatterns.map((pattern, k) => {
+          const ctx = ctxList[k] ?? null;
+          return {
+            re: new RegExp(pattern, sec.anchor_flags ?? ""),
+            prevRe: ctx?.prev !== void 0 ? new RegExp(ctx.prev, ctx.prev_flags ?? "") : null,
+            nextRe: ctx?.next !== void 0 ? new RegExp(ctx.next, ctx.next_flags ?? "") : null
+          };
+        });
+        const matchesCandidate = (c, i) => c.re.test(lines[i]) && (c.prevRe === null || i > 0 && c.prevRe.test(lines[i - 1])) && (c.nextRe === null || i < total - 1 && c.nextRe.test(lines[i + 1]));
+        let idx = -1;
+        for (const c of candidates) {
+          let candIdx = -1;
+          if (sec.anchor_last) {
+            for (let i = total - 1; i >= 0; i--) {
+              if (matchesCandidate(c, i)) {
+                candIdx = i;
+                break;
+              }
+            }
+          } else {
+            for (let i = 0; i < total; i++) {
+              if (matchesCandidate(c, i)) {
+                candIdx = i;
+                break;
+              }
+            }
+          }
+          if (candIdx !== -1 && (idx === -1 || candIdx < idx)) idx = candIdx;
+        }
+        if (idx !== -1) {
+          from = idx;
+          to = total;
+          if (sec.until_regex !== void 0) {
+            try {
+              const ure = new RegExp(sec.until_regex, sec.until_regex_flags ?? "");
+              const end = lines.findIndex((l, i) => i > idx && ure.test(l));
+              if (end !== -1) to = end;
+            } catch {
+            }
+          } else if (sec.lines !== void 0) {
+            to = Math.min(total, from + sec.lines);
+          }
+        }
+      } catch {
+      }
+    } else if (sec.from_top !== void 0) {
+      from = resolveSize(sec.from_top, total);
+      to = total;
+    } else if (sec.from_bottom !== void 0) {
+      const sz = resolveSize(sec.from_bottom, total);
+      from = total - sz;
+      to = total;
     }
-    if (buttons.length < minButtons) return null;
-    const message = buildMessage(spec, lines, question.index, start, end);
-    return { message, buttons };
-  };
-}
-var SEPARATOR_RE;
-var init_parse_approval = __esm({
-  "src/providers/sdk/v1/builders/cli/parse-approval.ts"() {
-    "use strict";
-    init_visible_region();
-    SEPARATOR_RE = /^(?:─|━|═|━){10,}\s*$/;
+    anchored.set(id, { fromLine: from, toLine: to });
   }
-});
-
-// src/providers/sdk/v1/builders/cli/parse-session.ts
-import * as crypto3 from "crypto";
-function stripAnsi2(text) {
-  return String(text || "").replace(/\x1b\[(\d*)C/g, (_m, n) => " ".repeat(Math.max(1, Number(n) || 1))).replace(/\x1b\[\d*D/g, "").replace(ANSI_RE, "").replace(OSC_RE, "").replace(/\x1b[P^_X][\s\S]*?(?:\x07|\x1b\\)/g, "").replace(/\x1b(?:[@-Z\\-_])/g, "");
+  const resolved = [];
+  for (const [id, sec] of sectionEntries) {
+    let { fromLine, toLine } = anchored.get(id);
+    if (sec.until !== void 0) {
+      if (sec.until.startsWith("^")) {
+        try {
+          const ure = new RegExp(sec.until);
+          const end = lines.findIndex((l, i) => i > fromLine && ure.test(l));
+          if (end !== -1) toLine = end;
+        } catch {
+        }
+      } else {
+        const target = anchored.get(sec.until);
+        if (target) toLine = target.fromLine;
+      }
+    }
+    if (toLine < fromLine) toLine = fromLine;
+    const text = lines.slice(fromLine, toLine).join("\n");
+    resolved.push({ id, fromLine, toLine, text });
+  }
+  return resolved;
 }
-function splitLines(text) {
-  return stripAnsi2(text).replace(//g, "").split(/\r?\n/).map((l) => l.replace(/\s+$/, ""));
+function sectionText(sections, sectionId, fullScreen) {
+  if (!sectionId) return fullScreen;
+  const found = sections.find((s2) => s2.id === sectionId);
+  return found ? found.text : "";
 }
-function pickInputText(input, scope) {
-  if (!input) return "";
-  if (scope === "screen") return String(input.screenText || input.screen?.text || "");
-  if (scope === "tail") return String(input.tail || input.recentBuffer || input.buffer || "");
-  return String(input.buffer || input.rawBuffer || input.screenText || "");
+function isRegexCondition(c) {
+  return "matches" in c;
 }
-function stableHash(value) {
-  return crypto3.createHash("sha1").update(String(value || "")).digest("hex").slice(0, 12);
+function isChangedCondition(c) {
+  return "cursor_above" in c && "changed" in c;
 }
-function normalizeMessageIdentity(messages, status) {
-  const list = Array.isArray(messages) ? messages : [];
-  let turnIndex = -1;
-  return list.map((message, index) => {
-    const role = message?.role || "assistant";
-    const kind = message?.kind || "standard";
-    const content = typeof message?.content === "string" ? message.content : "";
-    if (role === "user" || turnIndex < 0) turnIndex += 1;
-    const seed = [role, kind, "", index, content].join("\n");
-    const providerUnitKey = `v2-pty:${role}:${kind}:${index}:${stableHash(seed)}`;
-    const bubbleId = `bubble:${providerUnitKey}`;
-    const turnKey = `turn:${turnIndex}`;
-    const isStreamingTail = status === "generating" && role === "assistant" && index === list.length - 1;
-    return {
-      ...message,
-      providerUnitKey,
-      bubbleId,
-      sequence: index,
-      _turnKey: turnKey,
-      bubbleState: isStreamingTail ? "streaming" : "final"
-    };
-  });
+function isAllCondition(c) {
+  return "all" in c;
 }
-function buildParseSessionFromTui(spec) {
-  if (!spec.transcriptPty) {
-    throw new Error("buildParseSessionFromTui: spec.transcriptPty is required");
+function isAnyCondition(c) {
+  return "any" in c;
+}
+function evaluateCondition(cond, sections, fullScreen, cursor, prevLines, trace, stateId) {
+  if (isAllCondition(cond)) {
+    for (const child of cond.all) {
+      if (!evaluateCondition(child, sections, fullScreen, cursor, prevLines, trace, stateId)) {
+        return false;
+      }
+    }
+    return true;
   }
-  const assistantRe = new RegExp(spec.transcriptPty.assistantPrefix.regex, spec.transcriptPty.assistantPrefix.flags || "");
-  const userRe = spec.transcriptPty.userPrefix ? new RegExp(spec.transcriptPty.userPrefix.regex, spec.transcriptPty.userPrefix.flags || "") : null;
-  const toolRe = spec.transcriptPty.toolPrefix ? new RegExp(spec.transcriptPty.toolPrefix.regex, spec.transcriptPty.toolPrefix.flags || "") : null;
-  const toolSkip = spec.transcriptPty.toolPrefix?.skip ?? false;
-  const chromeRes = (spec.transcriptPty.chromePatterns || []).map((p) => new RegExp(p.regex, p.flags || ""));
-  const requireIndentForContinuation = spec.transcriptPty.continuationLine?.indented ?? false;
-  const stripLeadingChrome = spec.transcriptPty.stripLeadingChrome ?? true;
-  const scope = spec.transcriptPty.scope ?? "buffer";
-  const detectStatus = spec.spinner || spec.settledPrompt || spec.modal || spec.dispatchOrder ? buildDetectStatusFromTui({
-    spinner: spec.spinner,
-    settledPrompt: spec.settledPrompt,
-    modal: spec.modal,
-    dispatchOrder: spec.dispatchOrder
-  }) : () => null;
-  const parseApproval = spec.modal ? buildParseApprovalFromTui(spec.modal) : () => null;
-  const sessionIdRe = spec.sessionIdExtraction ? new RegExp(
-    spec.sessionIdExtraction.regex,
-    spec.sessionIdExtraction.flags ?? "i"
-  ) : null;
-  const sessionIdScope = spec.sessionIdExtraction?.scope ?? "tail";
-  return function parseSession(input) {
-    const status = detectStatus(input) ?? "idle";
-    const modal = parseApproval(input);
-    const text = pickInputText(input, scope);
-    const lines = splitLines(text);
-    const messages = [];
-    let seenFirstRoleLine = !stripLeadingChrome;
-    for (const raw of lines) {
-      const line = raw;
-      if (line.trim() === "") {
-        continue;
+  if (isAnyCondition(cond)) {
+    for (const child of cond.any) {
+      if (evaluateCondition(child, sections, fullScreen, cursor, prevLines, trace, stateId)) {
+        return true;
       }
-      let isChrome = false;
-      for (const cre of chromeRes) {
-        if (cre.test(line)) {
-          isChrome = true;
-          break;
-        }
+    }
+    return false;
+  }
+  if (isChangedCondition(cond)) {
+    if (!cursor || !prevLines || prevLines.length === 0) return false;
+    const curLines = fullScreen.split("\n");
+    const startRow = Math.max(0, cursor.row - cond.cursor_above);
+    const endRow = cursor.row;
+    const currentSlice = curLines.slice(startRow, endRow).join("\n");
+    const prevSlice = prevLines.slice(startRow, endRow).join("\n");
+    const didChange = currentSlice !== prevSlice;
+    const result = cond.changed ? didChange : !didChange;
+    const stableSuffix = cond.stable_ms != null ? ` stable_ms=${cond.stable_ms}` : "";
+    trace.push({
+      kind: result ? "state_match" : "state_skip",
+      text: `state[${stateId}] changed cond cursor_above=${cond.cursor_above} rows[${startRow},${endRow}) changed=${didChange} expected=${cond.changed}${stableSuffix} result=${result}`
+    });
+    return result;
+  }
+  if (isRegexCondition(cond)) {
+    const haystack = sectionText(sections, cond.section, fullScreen);
+    let matched = false;
+    try {
+      const re = new RegExp(cond.matches, cond.flags ?? "i");
+      matched = re.test(haystack);
+    } catch {
+      matched = false;
+    }
+    if (!matched) {
+      trace.push({ kind: "state_skip", text: `state[${stateId}] regex cond ${cond.section ?? "*"}~/${cond.matches}/ no match` });
+      return false;
+    }
+    if (cursor !== void 0) {
+      if (cond.cursor_row_min !== void 0 && cursor.row < cond.cursor_row_min) {
+        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor row ${cursor.row} < cursor_row_min ${cond.cursor_row_min}` });
+        return false;
       }
-      if (isChrome) continue;
-      const userMatch = userRe ? line.match(userRe) : null;
-      const toolMatch = toolRe ? line.match(toolRe) : null;
-      const assistMatch = line.match(assistantRe);
-      if (userMatch) {
-        seenFirstRoleLine = true;
-        const content = (userMatch[1] ?? userMatch[0]).trim();
-        if (content) messages.push({ role: "user", kind: "standard", content });
-        continue;
+      if (cond.cursor_row_max !== void 0 && cursor.row > cond.cursor_row_max) {
+        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor row ${cursor.row} > cursor_row_max ${cond.cursor_row_max}` });
+        return false;
       }
-      if (toolMatch) {
-        seenFirstRoleLine = true;
-        if (toolSkip) continue;
-        const content = (toolMatch[1] ?? toolMatch[0]).trim();
-        if (content) messages.push({ role: "assistant", kind: "tool", content });
-        continue;
+      if (cond.cursor_col_min !== void 0 && cursor.col < cond.cursor_col_min) {
+        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor col ${cursor.col} < cursor_col_min ${cond.cursor_col_min}` });
+        return false;
       }
-      if (assistMatch) {
-        seenFirstRoleLine = true;
-        const content = (assistMatch[1] ?? assistMatch[0]).trim();
-        if (content) messages.push({ role: "assistant", kind: "standard", content });
-        continue;
+      if (cond.cursor_col_max !== void 0 && cursor.col > cond.cursor_col_max) {
+        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor col ${cursor.col} > cursor_col_max ${cond.cursor_col_max}` });
+        return false;
       }
-      if (!seenFirstRoleLine) continue;
-      if (requireIndentForContinuation && !/^\s/.test(line)) continue;
-      const last = messages[messages.length - 1];
-      if (!last) continue;
-      const cont = line.replace(/^\s+/, "");
-      if (cont) last.content = last.content ? `${last.content}
-${cont}` : cont;
     }
-    const result = {
-      status,
-      messages,
-      activeModal: modal,
-      modal,
-      parsedStatus: status
-    };
-    if (sessionIdRe) {
-      const haystack = stripAnsi2(pickInputText(input, sessionIdScope));
-      const match = haystack.match(sessionIdRe);
-      const captured = match?.[1]?.trim();
-      if (captured) result.providerSessionId = captured;
+    trace.push({ kind: "state_match", text: `state[${stateId}] regex cond ${cond.section ?? "*"}~/${cond.matches}/ matched${cursor !== void 0 ? ` cursor=(${cursor.row},${cursor.col})` : ""}` });
+    return true;
+  }
+  return false;
+}
+function extractTitle(rule, sections, fullScreen) {
+  const hay = sectionText(sections, rule.section, fullScreen);
+  if (!hay) return null;
+  if (rule.first_line) {
+    const lines = hay.split("\n");
+    for (const line of lines) {
+      const stripped = line.trim();
+      if (stripped && !/^[─╌═─\s]+$/.test(stripped)) {
+        return stripped;
+      }
     }
-    return result;
-  };
+    return null;
+  }
+  if (rule.regex) {
+    try {
+      const re = new RegExp(rule.regex, rule.flags ?? "i");
+      const m = re.exec(hay);
+      if (m) return (m[1] ?? m[0]).trim();
+    } catch {
+    }
+  }
+  return null;
 }
-var ANSI_RE, OSC_RE;
-var init_parse_session = __esm({
-  "src/providers/sdk/v1/builders/cli/parse-session.ts"() {
+function compilePattern(ref) {
+  const flags = ref.flags ?? "gm";
+  return new RegExp(ref.pattern, flags.includes("g") ? flags : flags + "g");
+}
+function compileLinePattern(ref) {
+  const flags = (ref.flags ?? "m").replace(/g/g, "");
+  return new RegExp(ref.pattern, flags);
+}
+function extractButtonsFromRule(rule, hay) {
+  const keyTemplate = rule.key_for_index;
+  const continuationLines = rule.continuation_lines ?? false;
+  const buttons = [];
+  if (continuationLines) {
+    const re = compileLinePattern(rule);
+    const lines = hay.split("\n");
+    for (let i = 0; i < lines.length; i += 1) {
+      const m = re.exec(lines[i]);
+      if (!m) continue;
+      const idx = Number(m[1]);
+      let label = String(m[2] ?? "").trim();
+      if (!Number.isFinite(idx) || idx <= 0 || !label) continue;
+      const current = hasCursorMarker(lines[i]);
+      let j = i + 1;
+      while (j < lines.length) {
+        const next = lines[j];
+        if (!next.trim()) break;
+        if (re.test(next)) break;
+        if (!/^\s+/.test(next)) break;
+        label += " " + next.trim();
+        j += 1;
+      }
+      const key = keyTemplate.replace(/\{index\}/g, String(idx));
+      buttons.push({ index: idx, label, key, current });
+      i = j - 1;
+    }
+  } else {
+    const re = compilePattern(rule);
+    let m;
+    while ((m = re.exec(hay)) !== null) {
+      const idx = Number(m[1]);
+      const label = String(m[2] ?? "").trim();
+      if (!Number.isFinite(idx) || idx <= 0 || !label) continue;
+      const key = keyTemplate.replace(/\{index\}/g, String(idx));
+      buttons.push({ index: idx, label, key, current: hasCursorMarker(m[0]) });
+    }
+  }
+  const block2 = lastContiguousNumberedBlock(buttons);
+  block2.sort((a, b) => a.index - b.index);
+  return block2;
+}
+function lastContiguousNumberedBlock(entries) {
+  if (entries.length <= 1) return entries.slice();
+  let start = entries.length - 1;
+  for (let i = entries.length - 1; i > 0; i -= 1) {
+    if (entries[i - 1].index === entries[i].index - 1) start = i - 1;
+    else break;
+  }
+  return entries.slice(start);
+}
+function hasCursorMarker(text) {
+  return /^\s*[❯›>]/.test(text);
+}
+var init_evaluator = __esm({
+  "src/providers/spec/evaluator.ts"() {
     "use strict";
-    init_detect_status();
-    init_parse_approval();
-    ANSI_RE = /\x1b\[[0-?]*[ -/]*[@-~]/g;
-    OSC_RE = /\x1b\][^\x07\x1b\n]*(?:\x07|\x1b\\|(?=\n|$))/g;
   }
 });
 
-// src/cli-adapters/cli-script-runner.ts
-function summarizeInput(input) {
-  const screenText = typeof input?.screenText === "string" ? input.screenText : "";
-  const rawBuffer = typeof input?.rawBuffer === "string" ? input.rawBuffer : "";
-  const tail = typeof input?.tail === "string" ? input.tail : "";
-  return {
-    screenTextLen: screenText.length,
-    rawBufferLen: rawBuffer.length,
-    tailLen: tail.length,
-    isWaitingForResponse: typeof input?.isWaitingForResponse === "boolean" ? input.isWaitingForResponse : void 0,
-    screenTextHead: screenText ? screenText.slice(0, 200) : void 0
-  };
+// src/providers/spec/fsm-evaluator.ts
+var fsm_evaluator_exports = {};
+__export(fsm_evaluator_exports, {
+  evaluateConditionPreview: () => evaluateConditionPreview,
+  evaluateFsm: () => evaluateFsm
+});
+function regionKey(cursorAbove) {
+  return cursorAbove && cursorAbove > 0 ? cursorAbove : WHOLE_SCREEN;
 }
-function summarizeResult(result) {
-  try {
-    const json = JSON.stringify(result);
-    return json && json.length > 400 ? `${json.slice(0, 400)}\u2026[truncated ${json.length - 400}]` : json ?? "undefined";
-  } catch (e) {
-    return `<unserializable: ${e?.message || e}>`;
-  }
+function isRegex(c) {
+  return "matches" in c;
 }
-var TRACE_RING_CAPACITY, DEFAULT_SCRIPT_CALL_BUDGET_MS, BUDGET_WARN_THROTTLE_MS, CliScriptRunner;
-var init_cli_script_runner = __esm({
-  "src/cli-adapters/cli-script-runner.ts"() {
-    "use strict";
-    init_logger();
-    init_provider_cli_shared();
-    init_detect_status();
-    init_parse_approval();
-    init_parse_session();
-    TRACE_RING_CAPACITY = 64;
-    DEFAULT_SCRIPT_CALL_BUDGET_MS = 50;
-    BUDGET_WARN_THROTTLE_MS = 3e4;
-    CliScriptRunner = class {
-      scripts = {};
-      scriptState = null;
-      _parseErrorMessage = null;
-      cliType;
-      sdk = {};
-      invocationTrace = [];
-      /** Per-invocation wall-clock budget (ms). Configurable via setScriptCallBudget. */
-      scriptCallBudgetMs = DEFAULT_SCRIPT_CALL_BUDGET_MS;
-      /** Last WARN emit time per scriptName, used to throttle repeated budget violations. */
-      lastBudgetWarnAt = /* @__PURE__ */ new Map();
-      constructor(cliType) {
-        this.cliType = cliType;
+function isChanged(c) {
+  return "cursor_above" in c && "changed" in c;
+}
+function isElapsed(c) {
+  return "elapsed_ms" in c;
+}
+function isStable(c) {
+  return "stable_ms" in c;
+}
+function isAll(c) {
+  return "all" in c;
+}
+function isAny(c) {
+  return "any" in c;
+}
+function isNot(c) {
+  return "not" in c;
+}
+function evalCond(cond, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId) {
+  if (isAll(cond)) {
+    const children = cond.all.map((c) => evalCond(c, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId));
+    const result = children.every((c) => c.result);
+    const remainingMs = result ? 0 : Math.max(0, ...children.filter((c) => !c.result).map((c) => c.remainingMs ?? 0));
+    return { kind: "all", result, detail: `all(${children.length})`, remainingMs, children };
+  }
+  if (isAny(cond)) {
+    const children = cond.any.map((c) => evalCond(c, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId));
+    const result = children.some((c) => c.result);
+    const pending = children.filter((c) => !c.result).map((c) => c.remainingMs ?? Infinity);
+    const remainingMs = result ? 0 : pending.length ? Math.min(...pending) : 0;
+    return { kind: "any", result, detail: `any(${children.length})`, remainingMs: Number.isFinite(remainingMs) ? remainingMs : 0, children };
+  }
+  if (isNot(cond)) {
+    const child = evalCond(cond.not, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId);
+    return { kind: "not", result: !child.result, detail: `not`, remainingMs: 0, children: [child] };
+  }
+  if (isElapsed(cond)) {
+    const age = clock.now - clock.stateEnteredAt;
+    const result = age >= cond.elapsed_ms;
+    const remainingMs = result ? 0 : cond.elapsed_ms - age;
+    return { kind: "elapsed", result, detail: `elapsed ${age}ms / ${cond.elapsed_ms}ms`, remainingMs };
+  }
+  if (isStable(cond)) {
+    const key = regionKey(cond.cursor_above);
+    const lastChanged = clock.regionLastChangedAt.get(key) ?? clock.stateEnteredAt;
+    const stableFor = clock.now - lastChanged;
+    const result = stableFor >= cond.stable_ms;
+    const remainingMs = result ? 0 : cond.stable_ms - stableFor;
+    const where = key === WHOLE_SCREEN ? "screen" : `cursor_above=${cond.cursor_above}`;
+    return { kind: "stable", result, detail: `stable ${where} ${stableFor}ms / ${cond.stable_ms}ms`, remainingMs };
+  }
+  if (isRegex(cond) || isChanged(cond)) {
+    const result = evaluateCondition(cond, sections, fullScreen, cursor, prevLines, legacyTrace, stateId);
+    const kind = isRegex(cond) ? "regex" : "changed";
+    const detail = isRegex(cond) ? `${cond.section ?? "*"}~/${cond.matches}/` : `cursor_above=${cond.cursor_above} changed=${cond.changed}`;
+    let matchedText;
+    if (result && isRegex(cond)) {
+      try {
+        const hay = sectionText(sections, cond.section, fullScreen);
+        const re = new RegExp(cond.matches, cond.flags ?? "i");
+        const m = re.exec(hay);
+        if (m && m[0]) matchedText = m[0].replace(/\s+/g, " ").trim().slice(0, 160);
+      } catch {
       }
-      /** Returns the most-recent script invocation traces (oldest → newest). */
-      getInvocationTrace() {
-        return this.invocationTrace.slice();
-      }
-      /** Clear the trace ring — used by tests and after PTY reset. */
-      clearInvocationTrace() {
-        this.invocationTrace = [];
-      }
-      /**
-       * Configure the wall-clock budget (ms) applied to every script invocation.
-       *
-       * Out-of-range or non-finite values are clamped to [1, 5000] and the
-       * default (50ms) is used as a fallback. The budget is enforced per-call,
-       * not aggregated — it does not abort a runaway script (Node CJS cannot
-       * interrupt synchronous code without a worker thread). Instead, an
-       * exceeded budget flags the trace entry with `timedOut: true` and emits
-       * a throttled WARN naming the script and elapsed time so an operator
-       * can identify which provider is hanging the settle loop.
-       */
-      setScriptCallBudget(ms) {
-        if (typeof ms !== "number" || !Number.isFinite(ms)) {
-          this.scriptCallBudgetMs = DEFAULT_SCRIPT_CALL_BUDGET_MS;
-          return;
-        }
-        const clamped = Math.max(1, Math.min(5e3, Math.floor(ms)));
-        this.scriptCallBudgetMs = clamped;
-      }
-      /** Test/debug accessor — current effective budget in ms. */
-      getScriptCallBudgetMs() {
-        return this.scriptCallBudgetMs;
-      }
-      recordTrace(entry) {
-        this.invocationTrace.push(entry);
-        if (this.invocationTrace.length > TRACE_RING_CAPACITY) {
-          this.invocationTrace.splice(0, this.invocationTrace.length - TRACE_RING_CAPACITY);
-        }
-      }
-      // ─── Script lifecycle ─────────────────────────────
-      setScripts(scripts, providerTui) {
-        this.sdk = this.buildSdk(providerTui);
-        const tui = providerTui;
-        const enriched = { ...scripts };
-        if (typeof enriched.detectStatus !== "function" && this.sdk.declarativeDetectStatus) {
-          enriched.detectStatus = this.sdk.declarativeDetectStatus;
-        }
-        if (typeof enriched.parseApproval !== "function" && this.sdk.declarativeParseApproval) {
-          enriched.parseApproval = this.sdk.declarativeParseApproval;
-        }
-        if (typeof enriched.parseSession !== "function" && tui?.transcriptPty) {
-          try {
-            const synth = buildParseSessionFromTui({
-              spinner: tui.spinner,
-              settledPrompt: tui.settledPrompt,
-              modal: tui.modal,
-              dispatchOrder: tui.dispatchOrder,
-              transcriptPty: tui.transcriptPty
-            });
-            enriched.parseSession = ((input) => {
-              const out = synth(input);
-              return {
-                ...out,
-                messages: normalizeMessageIdentity(out.messages, out.status ?? "idle")
-              };
-            });
-          } catch (e) {
-            LOG.warn("CLI", `[${this.cliType}] buildParseSessionFromTui failed: ${e?.message || e}`);
-          }
-        }
-        this.scripts = enriched;
-        this._parseErrorMessage = null;
-        this.scriptState = typeof enriched.createState === "function" ? enriched.createState() ?? null : null;
-      }
-      buildSdk(providerTui) {
-        const tui = providerTui;
-        if (!tui) return {};
-        const sdk = {};
-        if (tui.spinner || tui.settledPrompt || tui.modal || tui.dispatchOrder) {
-          try {
-            sdk.declarativeDetectStatus = buildDetectStatusFromTui({
-              spinner: tui.spinner,
-              settledPrompt: tui.settledPrompt,
-              modal: tui.modal,
-              dispatchOrder: tui.dispatchOrder
-            });
-          } catch (e) {
-            LOG.warn("CLI", `[${this.cliType}] buildDetectStatusFromTui failed: ${e?.message || e}`);
-          }
-        }
-        if (tui.modal) {
-          try {
-            sdk.declarativeParseApproval = buildParseApprovalFromTui(tui.modal);
-          } catch (e) {
-            LOG.warn("CLI", `[${this.cliType}] buildParseApprovalFromTui failed: ${e?.message || e}`);
-          }
-        }
-        return sdk;
-      }
-      /** Reset per-session state — called when the PTY process exits. */
-      resetSessionState() {
-        this.scriptState = null;
-        this.invocationTrace = [];
-        this.lastBudgetWarnAt.clear();
-      }
-      // ─── Script access (for reflection and test patching) ────────────────────
-      /** Returns the live scripts object. Direct property assignment on this object
-       *  patches individual scripts without replacing others (used in tests). */
-      get cliScripts() {
-        return this.scripts;
+    }
+    return matchedText ? { kind, result, detail, matchedText } : { kind, result, detail };
+  }
+  return { kind: "all", result: false, detail: "unknown condition" };
+}
+function fromLabel(t) {
+  const from = Array.isArray(t.from) ? t.from.join("|") : t.from;
+  return t.label ?? `${from}\u2192${t.to}`;
+}
+function evaluateFsm(spec, currentStateId, screenText, cursor, prevLines, clock) {
+  const legacyTrace = [];
+  const lines = screenText.split("\n").map((l) => l.endsWith("\r") ? l.slice(0, -1) : l);
+  const cleanScreen = lines.join("\n");
+  const sections = resolveSections(spec.sections ?? {}, lines);
+  const outgoing = outgoingTransitions(spec, currentStateId);
+  const transitions = [];
+  let fired = null;
+  for (const t of outgoing) {
+    const holdMs = t.min_hold_ms ?? 0;
+    const heldFor = clock.now - clock.stateEnteredAt;
+    const holdSatisfied = heldFor >= holdMs;
+    const holdRemainingMs = holdSatisfied ? 0 : holdMs - heldFor;
+    let cond;
+    let condResult = true;
+    if (t.when) {
+      cond = evalCond(t.when, sections, cleanScreen, cursor, prevLines, clock, legacyTrace, `${currentStateId}\u2192${t.to}`);
+      condResult = cond.result;
+    }
+    const fires = holdSatisfied && condResult;
+    const te = {
+      to: t.to,
+      label: fromLabel(t),
+      eligible: true,
+      holdSatisfied,
+      holdRemainingMs,
+      condResult,
+      cond,
+      fires,
+      priority: t.priority ?? 0
+    };
+    transitions.push(te);
+    if (fires && !fired) fired = te;
+  }
+  if (fired && !stateById(spec, fired.to)) {
+    legacyTrace.push({ kind: "state_skip", text: `transition target ${fired.to} not found` });
+    fired = null;
+  }
+  return { sections, transitions, fired, trace: legacyTrace };
+}
+function evaluateConditionPreview(cond, sections, screenText, cursor) {
+  const lines = screenText.split("\n").map((l) => l.endsWith("\r") ? l.slice(0, -1) : l);
+  const cleanScreen = lines.join("\n");
+  const resolved = resolveSections(sections ?? {}, lines);
+  const clock = { now: 0, stateEnteredAt: 0, regionLastChangedAt: /* @__PURE__ */ new Map() };
+  return evalCond(cond, resolved, cleanScreen, cursor, void 0, clock, [], "preview");
+}
+var WHOLE_SCREEN;
+var init_fsm_evaluator = __esm({
+  "src/providers/spec/fsm-evaluator.ts"() {
+    "use strict";
+    init_evaluator();
+    init_fsm_types();
+    WHOLE_SCREEN = -1;
+  }
+});
+
+// src/cli-adapters/pty-transport.ts
+var pty_transport_exports = {};
+__export(pty_transport_exports, {
+  NodePtyTransportFactory: () => NodePtyTransportFactory
+});
+import * as os13 from "os";
+function loadNodePty() {
+  if (cachedPty !== void 0) return cachedPty;
+  try {
+    cachedPty = __require("node-pty");
+    ensureNodePtySpawnHelperPermissions();
+  } catch {
+    cachedPty = null;
+  }
+  return cachedPty;
+}
+var cachedPty, NodePtyRuntimeTransport, NodePtyTransportFactory;
+var init_pty_transport = __esm({
+  "src/cli-adapters/pty-transport.ts"() {
+    "use strict";
+    init_spawn_env();
+    init_resolve_executable();
+    NodePtyRuntimeTransport = class {
+      constructor(handle) {
+        this.handle = handle;
       }
-      // ─── Capability checks ────────────────────────────
-      hasDetectStatus() {
-        return typeof this.scripts.detectStatus === "function";
+      ready = Promise.resolve();
+      terminalQueriesHandled = false;
+      get pid() {
+        return this.handle.pid;
       }
-      hasParseSession() {
-        return typeof this.scripts.parseSession === "function";
+      write(data) {
+        this.handle.write(data);
       }
-      getScriptNames() {
-        return listCliScriptNames(this.scripts);
+      resize(cols, rows) {
+        this.handle.resize(cols, rows);
       }
-      // ─── Error state ──────────────────────────────────
-      get parseErrorMessage() {
-        return this._parseErrorMessage;
+      kill() {
+        this.handle.kill();
       }
-      clearParseError() {
-        this._parseErrorMessage = null;
+      getMetadata() {
+        return null;
       }
-      // ─── Script invocation ────────────────────────────
-      detectStatus(input) {
-        if (!this.scripts.detectStatus) return null;
-        try {
-          return this.invoke("detectStatus", this.scripts.detectStatus, input);
-        } catch (e) {
-          LOG.warn("CLI", `[${this.cliType}] detectStatus error: ${e?.message || e}`);
-          return null;
-        }
+      onData(callback) {
+        this.handle.onData(callback);
       }
-      parseApproval(input) {
-        if (!this.scripts.parseApproval) return null;
-        try {
-          return this.invoke(
-            "parseApproval",
-            this.scripts.parseApproval,
-            input
-          );
-        } catch (e) {
-          LOG.warn("CLI", `[${this.cliType}] parseApproval error: ${e?.message || e}`);
-          return null;
-        }
+      onExit(callback) {
+        this.handle.onExit(callback);
       }
-      parseSession(input) {
-        if (!this.scripts.parseSession) {
-          this._parseErrorMessage = `${this.cliType} parseSession unavailable`;
-          return null;
-        }
-        try {
-          const result = this.invoke("parseSession", this.scripts.parseSession, input);
-          this._parseErrorMessage = null;
-          return result && typeof result === "object" ? result : null;
-        } catch (e) {
-          this._parseErrorMessage = e?.message || String(e);
-          LOG.warn("CLI", `[${this.cliType}] parseSession error: ${this._parseErrorMessage}`);
-          return null;
+    };
+    NodePtyTransportFactory = class {
+      spawn(command, args, options) {
+        const pty = loadNodePty();
+        if (!pty) throw new Error("node-pty is not installed");
+        let cwd = options.cwd;
+        if (cwd) {
+          try {
+            const fs32 = __require("fs");
+            const stat2 = fs32.statSync(cwd);
+            if (!stat2.isDirectory()) cwd = os13.homedir();
+          } catch {
+            cwd = os13.homedir();
+          }
         }
+        const handle = pty.spawn(resolveWin32Executable(command), args, {
+          name: "xterm-256color",
+          cols: options.cols,
+          rows: options.rows,
+          cwd,
+          env: options.env
+        });
+        return new NodePtyRuntimeTransport(handle);
       }
-      /**
-       * Invoke an arbitrary named script (e.g. setModel, openModelPicker).
-       * Throws if the script is not available.
-       */
-      invokeByName(name, input) {
-        const fn = this.scripts[name];
-        if (typeof fn !== "function") {
-          throw new Error(`CLI script '${name}' not available`);
+    };
+  }
+});
+
+// src/providers/sdk/v1/builders/cli/visible-region.ts
+function compile(re, flags) {
+  try {
+    return new RegExp(re, flags ?? "");
+  } catch (e) {
+    throw new Error(`Invalid visible-region anchor regex /${re}/${flags ?? ""}: ${e.message}`);
+  }
+}
+function findAllMatches(re, text) {
+  const results = [];
+  const iter = new RegExp(re.source, re.flags.replace("g", "") + "g");
+  let m;
+  while ((m = iter.exec(text)) !== null) {
+    results.push(m);
+    if (m[0].length === 0) iter.lastIndex += 1;
+  }
+  return results;
+}
+function applyVisibleRegion(spec, text) {
+  if (!text) return text;
+  switch (spec.scope) {
+    case "screen":
+    case "buffer":
+      return text;
+    case "tail": {
+      const limit = spec.tailChars ?? 4e3;
+      if (text.length <= limit) return text;
+      return text.slice(-limit);
+    }
+    case "between-anchors": {
+      const anchors = spec.anchors;
+      if (!anchors?.top && !anchors?.bottom) return text;
+      const selectLast = (spec.selectAnchor ?? "first") === "last";
+      let topEnd = 0;
+      if (anchors.top) {
+        const topRe = compile(anchors.top.pattern, anchors.top.flags);
+        const topMatches = findAllMatches(topRe, text);
+        if (topMatches.length === 0) {
+          return text;
         }
-        return this.invoke(name, fn, input);
+        const chosen = selectLast ? topMatches[topMatches.length - 1] : topMatches[0];
+        topEnd = chosen.index + chosen[0].length;
       }
-      // ─── Internal ─────────────────────────────────────
-      invoke(scriptName, fn, input) {
-        const arity = fn.length;
-        const startedAt = Date.now();
-        const startedHr = typeof process !== "undefined" && typeof process.hrtime === "function" ? process.hrtime.bigint() : null;
-        let result;
-        try {
-          if (arity >= 3) {
-            result = fn(this.scriptState, input, this.sdk);
-          } else if (arity === 2) {
-            result = fn(this.scriptState, input);
-          } else {
-            result = fn(input);
-          }
-          const elapsedUs = startedHr ? Number((process.hrtime.bigint() - startedHr) / 1000n) : 0;
-          const timedOut = this.checkBudget(scriptName, elapsedUs);
-          this.recordTrace({
-            at: startedAt,
-            scriptName,
-            arity,
-            inputSummary: summarizeInput(input),
-            ok: true,
-            elapsedUs,
-            resultSummary: summarizeResult(result),
-            ...timedOut ? { timedOut: true } : {}
-          });
-          return result;
-        } catch (e) {
-          const elapsedUs = startedHr ? Number((process.hrtime.bigint() - startedHr) / 1000n) : 0;
-          const timedOut = this.checkBudget(scriptName, elapsedUs);
-          this.recordTrace({
-            at: startedAt,
-            scriptName,
-            arity,
-            inputSummary: summarizeInput(input),
-            ok: false,
-            elapsedUs,
-            error: e?.message ? String(e.message).slice(0, 400) : String(e).slice(0, 400),
-            ...timedOut ? { timedOut: true } : {}
-          });
-          throw e;
+      let bottomStart = text.length;
+      if (anchors.bottom) {
+        const bottomRe = compile(anchors.bottom.pattern, anchors.bottom.flags);
+        const searchFrom = topEnd;
+        const suffix = text.slice(searchFrom);
+        const bottomMatches = findAllMatches(bottomRe, suffix);
+        if (bottomMatches.length === 0) {
+          return text;
         }
+        const chosen = selectLast ? bottomMatches[bottomMatches.length - 1] : bottomMatches[0];
+        bottomStart = searchFrom + chosen.index;
       }
-      /**
-       * Returns true when `elapsedUs` exceeded the configured budget. On the
-       * first violation per script (or after the throttle window expires) we
-       * emit a single WARN so the operator learns which provider is slow.
-       *
-       * We deliberately throttle per-scriptName so a chronically-slow
-       * detectStatus doesn't spam the log on every PTY frame settle.
-       */
-      checkBudget(scriptName, elapsedUs) {
-        const budgetUs = this.scriptCallBudgetMs * 1e3;
-        if (elapsedUs <= budgetUs) return false;
-        const now = Date.now();
-        const last = this.lastBudgetWarnAt.get(scriptName) ?? 0;
-        if (now - last >= BUDGET_WARN_THROTTLE_MS) {
-          this.lastBudgetWarnAt.set(scriptName, now);
-          LOG.warn(
-            "CLI",
-            `[${this.cliType}] script ${scriptName} took ${elapsedUs}us, budget ${budgetUs}us`
-          );
-        }
-        return true;
+      if (topEnd >= bottomStart) {
+        return text;
       }
-    };
+      return text.slice(topEnd, bottomStart);
+    }
+    default:
+      return text;
+  }
+}
+var init_visible_region = __esm({
+  "src/providers/sdk/v1/builders/cli/visible-region.ts"() {
+    "use strict";
   }
 });
 
-// src/cli-adapters/provider-cli-parse.ts
-function sliceFromOffset(text, start) {
+// src/providers/sdk/v1/builders/cli/detect-status.ts
+function compile2(re, flags) {
+  try {
+    return new RegExp(re, flags ?? "");
+  } catch (e) {
+    throw new Error(`Invalid regex /${re}/${flags ?? ""}: ${e.message}`);
+  }
+}
+function takeTail(text, lines) {
   if (!text) return "";
-  if (!Number.isFinite(start) || start <= 0) return text;
-  if (start >= text.length) return "";
-  return text.slice(start);
+  const split = text.split("\n");
+  if (split.length <= lines) return text;
+  return split.slice(-lines).join("\n");
 }
-function normalizeCliParsedMessages(parsedMessages, _options) {
-  return Array.isArray(parsedMessages) ? parsedMessages : [];
+function scopeText(input, scope, windowLines) {
+  const lines = windowLines && windowLines > 0 ? windowLines : 8;
+  switch (scope) {
+    case "whole-screen":
+      return input.screenText ?? "";
+    case "recent-buffer":
+      return input.tail ?? "";
+    case "last-n-lines":
+    case "live-frame-tail":
+    case void 0:
+    default:
+      return takeTail(input.screenText ?? "", lines);
+  }
 }
-function buildCliParseInput(options) {
-  const {
-    accumulatedBuffer,
-    accumulatedRawBuffer,
-    recentOutputBuffer,
-    terminalScreenText,
-    workingDir,
-    providerSessionId,
-    historySessionId,
-    baseMessages,
-    partialResponse,
-    isWaitingForResponse,
-    scope,
-    runtimeSettings,
-    spawnAt
-  } = options;
-  const buffer = scope ? sliceFromOffset(accumulatedBuffer, scope.bufferStart) : accumulatedBuffer;
-  const rawBuffer = scope ? sliceFromOffset(accumulatedRawBuffer, scope.rawBufferStart) : accumulatedRawBuffer;
-  const screenText = terminalScreenText;
-  const recentBuffer = buffer.slice(-1e3) || recentOutputBuffer;
-  return {
-    buffer,
-    rawBuffer,
-    recentBuffer,
-    screenText,
-    workspace: workingDir,
-    workingDir,
-    providerSessionId,
-    historySessionId,
-    screen: buildCliScreenSnapshot(screenText),
-    bufferScreen: buildCliScreenSnapshot(buffer),
-    recentScreen: buildCliScreenSnapshot(recentBuffer),
-    messages: [...baseMessages],
-    partialResponse,
-    isWaitingForResponse,
-    promptText: scope?.prompt || "",
-    settings: { ...runtimeSettings },
-    ...typeof spawnAt === "number" && spawnAt > 0 ? { spawnAt } : {}
-  };
+function compileSpinnerMatchers(spec) {
+  return spec.patterns.map((p) => compile2(p.regex, p.flags ?? "i"));
 }
-function summarizeCliTraceText(text, max = 800) {
-  const value = sanitizeTerminalText(String(text || ""));
-  if (value.length <= max) return value;
-  return `\u2026${value.slice(-max)}`;
+function compileSettledPromptMatchers(spec) {
+  const prompt = compile2(spec.regex, spec.flags ?? "m");
+  const footers = (spec.withFooter ?? []).map((f) => {
+    if (f.kind === "regex") {
+      const re = compile2(f.pattern, f.flags ?? "i");
+      return { test: (s2) => re.test(s2) };
+    }
+    const needle = f.pattern.toLowerCase();
+    return { test: (s2) => s2.toLowerCase().includes(needle) };
+  });
+  return { prompt, footers };
 }
-var init_provider_cli_parse = __esm({
-  "src/cli-adapters/provider-cli-parse.ts"() {
-    "use strict";
-    init_provider_cli_shared();
-  }
-});
+function extractButtonLabels(spec, text) {
+  if (!text) return [];
+  const flags = spec.buttonFlags && spec.buttonFlags.includes("m") ? spec.buttonFlags : `${spec.buttonFlags ?? ""}m`;
+  const buttonRe = compile2(spec.buttonPattern, flags);
+  const labelGroup = Number.isInteger(spec.buttonLabelGroup) && (spec.buttonLabelGroup ?? 0) > 0 ? spec.buttonLabelGroup : 1;
+  const out = [];
+  for (const line of text.split("\n")) {
+    buttonRe.lastIndex = 0;
+    const m = buttonRe.exec(line);
+    if (!m) continue;
+    const captured = m[labelGroup] ?? (labelGroup === 1 && m.length > 2 ? m[m.length - 1] : void 0);
+    if (captured && captured.trim()) out.push(captured.trim());
+  }
+  return out;
+}
+function buttonBlockApprovalCue(spec, text) {
+  const labels = extractButtonLabels(spec, text);
+  if (labels.length < 2) return false;
+  if (pickApprovalButton(labels).index < 0) return false;
+  return hasNegativeApprovalOption(labels);
+}
+function modalMatches(spec, input) {
+  const text = input.screenText ?? "";
+  const question = compile2(spec.questionPattern, spec.questionFlags ?? "i");
+  if (question.test(text)) return true;
+  for (const variant of spec.questionVariants ?? []) {
+    const re = compile2(variant.regex, variant.flags ?? "i");
+    if (re.test(text)) return true;
+  }
+  if (buttonBlockApprovalCue(spec, text)) return true;
+  return false;
+}
+function evaluateGroup(group, spec, input, compiled) {
+  switch (group) {
+    case "spinner": {
+      if (!spec.spinner || !compiled.spinner) return null;
+      const text = scopeText(input, spec.spinner.scope, spec.spinner.scopeWindowLines);
+      return compiled.spinner.some((re) => re.test(text)) ? "generating" : null;
+    }
+    case "modal": {
+      if (!spec.modal) return null;
+      return modalMatches(spec.modal, input) ? "waiting_approval" : null;
+    }
+    case "settled-prompt": {
+      if (!spec.settledPrompt || !compiled.settled) return null;
+      const text = scopeText(input, spec.settledPrompt.scope, spec.settledPrompt.scopeWindowLines);
+      if (!compiled.settled.prompt.test(text)) return null;
+      if (compiled.settled.footers.length === 0) return "idle";
+      return compiled.settled.footers.every((f) => f.test(text)) ? "idle" : null;
+    }
+    // Groups declared in the catalog but not yet implemented as builder steps
+    // return null so they are no-ops in dispatch — declaring them in `order`
+    // is forward-compatible. Phase 2 Week 8+ will wire them.
+    case "cue-ordering":
+    case "error-detection":
+    case "approval-stitching":
+      return null;
+    default:
+      return null;
+  }
+}
+function buildDetectStatusFromTui(spec) {
+  const compiledSpinner = spec.spinner ? compileSpinnerMatchers(spec.spinner) : null;
+  const compiledSettled = spec.settledPrompt ? compileSettledPromptMatchers(spec.settledPrompt) : null;
+  const compiled = { spinner: compiledSpinner, settled: compiledSettled };
+  const order = spec.dispatchOrder?.order && spec.dispatchOrder.order.length > 0 ? spec.dispatchOrder.order : DEFAULT_ORDER;
+  return function detectStatus(input) {
+    const effectiveInput = spec.visibleRegion ? {
+      ...input,
+      screenText: applyVisibleRegion(spec.visibleRegion, input.screenText ?? ""),
+      tail: applyVisibleRegion(spec.visibleRegion, input.tail)
+    } : input;
+    for (const group of order) {
+      const verdict = evaluateGroup(group, spec, effectiveInput, compiled);
+      if (verdict !== null) return verdict;
+    }
+    return null;
+  };
+}
+var DEFAULT_ORDER;
+var init_detect_status = __esm({
+  "src/providers/sdk/v1/builders/cli/detect-status.ts"() {
+    "use strict";
+    init_visible_region();
+    init_approval_utils();
+    DEFAULT_ORDER = ["spinner", "modal", "settled-prompt"];
+  }
+});
 
-// src/cli-adapters/cli-state-engine.ts
-var SCRIPT_STATUS_DEBOUNCE_MS, MAX_FINISH_RETRIES, FINISH_RETRY_DELAY_MS, MAX_TRACE_ENTRIES, APPROVAL_EXIT_TIMEOUT_MS, IDLE_CONFIRMATION_GRACE_MS, CliStateEngine;
-var init_cli_state_engine = __esm({
-  "src/cli-adapters/cli-state-engine.ts"() {
+// src/providers/sdk/v1/builders/cli/parse-approval.ts
+function compile3(re, flags) {
+  try {
+    return new RegExp(re, flags);
+  } catch (e) {
+    throw new Error(`Invalid regex /${re}/${flags ?? ""}: ${e.message}`);
+  }
+}
+function findQuestionLineIndex(spec, lines) {
+  const primary = compile3(spec.questionPattern, spec.questionFlags ?? "i");
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    if (primary.test(lines[i])) return { index: i, matchedSource: "primary" };
+  }
+  for (const variant of spec.questionVariants ?? []) {
+    const re = compile3(variant.regex, variant.flags ?? "i");
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+      if (re.test(lines[i])) return { index: i, matchedSource: variant.label ?? "variant" };
+    }
+  }
+  return null;
+}
+function scopeLines(spec, lines, questionIndex) {
+  const scope = spec.scope ?? "between-last-two-separators";
+  if (scope === "whole-screen") {
+    return { start: 0, end: lines.length };
+  }
+  if (scope === "window-around-question") {
+    const window = spec.scopeWindowLines ?? 16;
+    return {
+      start: Math.max(0, questionIndex - 2),
+      end: Math.min(lines.length, questionIndex + window)
+    };
+  }
+  let lastSep = -1;
+  let prevSep = -1;
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    if (SEPARATOR_RE.test(lines[i].trim())) {
+      if (lastSep < 0) lastSep = i;
+      else if (prevSep < 0) {
+        prevSep = i;
+        break;
+      }
+    }
+  }
+  if (lastSep >= 0 && prevSep >= 0) {
+    return { start: prevSep, end: lastSep + 1 };
+  }
+  return {
+    start: Math.max(0, questionIndex - 4),
+    end: Math.min(lines.length, questionIndex + 16)
+  };
+}
+function extractButtons(spec, lines, windowStart, windowEnd) {
+  const buttonRe = compile3(spec.buttonPattern, spec.buttonFlags ?? "m");
+  const out = [];
+  const labelGroup = Number.isInteger(spec.buttonLabelGroup) && (spec.buttonLabelGroup ?? 0) > 0 ? spec.buttonLabelGroup : 1;
+  let i = windowStart;
+  while (i < windowEnd) {
+    const line = lines[i];
+    const m = buttonRe.exec(line);
+    const captured = m?.[labelGroup] ?? (labelGroup === 1 && m && m.length > 2 ? m[m.length - 1] : void 0);
+    if (m && captured) {
+      let label = captured.trim();
+      if (spec.continuationLines) {
+        let j = i + 1;
+        while (j < windowEnd) {
+          const next = lines[j];
+          if (!next.trim()) break;
+          if (buttonRe.test(next)) break;
+          if (!/^\s+/.test(next)) break;
+          label += " " + next.trim();
+          j += 1;
+        }
+        i = j;
+      } else {
+        i += 1;
+      }
+      out.push(label);
+    } else {
+      i += 1;
+    }
+  }
+  return out;
+}
+function buildMessage(spec, lines, questionIndex, windowStart, windowEnd) {
+  const messageParts = [];
+  if (spec.contextHeader) {
+    const ctxRe = compile3(spec.contextHeader.regex, (spec.contextHeader.flags ?? "i") + "m");
+    const haystack = lines.slice(windowStart, windowEnd).join("\n");
+    const m = ctxRe.exec(haystack);
+    if (m) messageParts.push(m[1] ? m[1].trim() : m[0].trim());
+  }
+  messageParts.push(lines[questionIndex].trim());
+  return messageParts.filter(Boolean).join(" \u2014 ");
+}
+function extractInlineButtons(spec, lines, windowStart, windowEnd) {
+  if (!spec.inlineButtonPattern) return [];
+  const declaredFlags = spec.inlineButtonFlags ?? "gi";
+  const flags = declaredFlags.includes("g") ? declaredFlags : declaredFlags + "g";
+  const re = compile3(spec.inlineButtonPattern, flags);
+  const out = [];
+  for (let i = windowStart; i < windowEnd; i += 1) {
+    let m;
+    re.lastIndex = 0;
+    while ((m = re.exec(lines[i])) !== null) {
+      const label = (m[1] ?? m[0]).trim();
+      if (label && !out.includes(label)) out.push(label);
+      if (m.index === re.lastIndex) re.lastIndex += 1;
+    }
+  }
+  return out;
+}
+function buildParseApprovalFromTui(spec, visibleRegion) {
+  const minButtons = spec.minButtons ?? 2;
+  return function parseApproval(input) {
+    const rawText = input.screenText ?? input.buffer ?? "";
+    if (!rawText) return null;
+    const text = visibleRegion ? applyVisibleRegion(visibleRegion, rawText) : rawText;
+    const lines = text.split("\n");
+    const question = findQuestionLineIndex(spec, lines);
+    if (!question) return null;
+    const { start, end } = scopeLines(spec, lines, question.index);
+    if (question.index < start || question.index >= end) return null;
+    let buttons = extractButtons(spec, lines, question.index + 1, end);
+    if (buttons.length < minButtons && spec.inlineButtonPattern) {
+      buttons = extractInlineButtons(spec, lines, question.index, end);
+    }
+    if (buttons.length < minButtons) return null;
+    const message = buildMessage(spec, lines, question.index, start, end);
+    return { message, buttons };
+  };
+}
+var SEPARATOR_RE;
+var init_parse_approval = __esm({
+  "src/providers/sdk/v1/builders/cli/parse-approval.ts"() {
+    "use strict";
+    init_visible_region();
+    SEPARATOR_RE = /^(?:─|━|═|━){10,}\s*$/;
+  }
+});
+
+// src/providers/sdk/v1/builders/cli/parse-session.ts
+import * as crypto3 from "crypto";
+function stripAnsi2(text) {
+  return String(text || "").replace(/\x1b\[(\d*)C/g, (_m, n) => " ".repeat(Math.max(1, Number(n) || 1))).replace(/\x1b\[\d*D/g, "").replace(ANSI_RE, "").replace(OSC_RE, "").replace(/\x1b[P^_X][\s\S]*?(?:\x07|\x1b\\)/g, "").replace(/\x1b(?:[@-Z\\-_])/g, "");
+}
+function splitLines(text) {
+  return stripAnsi2(text).replace(//g, "").split(/\r?\n/).map((l) => l.replace(/\s+$/, ""));
+}
+function pickInputText(input, scope) {
+  if (!input) return "";
+  if (scope === "screen") return String(input.screenText || input.screen?.text || "");
+  if (scope === "tail") return String(input.tail || input.recentBuffer || input.buffer || "");
+  return String(input.buffer || input.rawBuffer || input.screenText || "");
+}
+function stableHash(value) {
+  return crypto3.createHash("sha1").update(String(value || "")).digest("hex").slice(0, 12);
+}
+function normalizeMessageIdentity(messages, status) {
+  const list = Array.isArray(messages) ? messages : [];
+  let turnIndex = -1;
+  return list.map((message, index) => {
+    const role = message?.role || "assistant";
+    const kind = message?.kind || "standard";
+    const content = typeof message?.content === "string" ? message.content : "";
+    if (role === "user" || turnIndex < 0) turnIndex += 1;
+    const seed = [role, kind, "", index, content].join("\n");
+    const providerUnitKey = `v2-pty:${role}:${kind}:${index}:${stableHash(seed)}`;
+    const bubbleId = `bubble:${providerUnitKey}`;
+    const turnKey = `turn:${turnIndex}`;
+    const isStreamingTail = status === "generating" && role === "assistant" && index === list.length - 1;
+    return {
+      ...message,
+      providerUnitKey,
+      bubbleId,
+      sequence: index,
+      _turnKey: turnKey,
+      bubbleState: isStreamingTail ? "streaming" : "final"
+    };
+  });
+}
+function buildParseSessionFromTui(spec) {
+  if (!spec.transcriptPty) {
+    throw new Error("buildParseSessionFromTui: spec.transcriptPty is required");
+  }
+  const assistantRe = new RegExp(spec.transcriptPty.assistantPrefix.regex, spec.transcriptPty.assistantPrefix.flags || "");
+  const userRe = spec.transcriptPty.userPrefix ? new RegExp(spec.transcriptPty.userPrefix.regex, spec.transcriptPty.userPrefix.flags || "") : null;
+  const toolRe = spec.transcriptPty.toolPrefix ? new RegExp(spec.transcriptPty.toolPrefix.regex, spec.transcriptPty.toolPrefix.flags || "") : null;
+  const toolSkip = spec.transcriptPty.toolPrefix?.skip ?? false;
+  const chromeRes = (spec.transcriptPty.chromePatterns || []).map((p) => new RegExp(p.regex, p.flags || ""));
+  const requireIndentForContinuation = spec.transcriptPty.continuationLine?.indented ?? false;
+  const stripLeadingChrome = spec.transcriptPty.stripLeadingChrome ?? true;
+  const scope = spec.transcriptPty.scope ?? "buffer";
+  const detectStatus = spec.spinner || spec.settledPrompt || spec.modal || spec.dispatchOrder ? buildDetectStatusFromTui({
+    spinner: spec.spinner,
+    settledPrompt: spec.settledPrompt,
+    modal: spec.modal,
+    dispatchOrder: spec.dispatchOrder
+  }) : () => null;
+  const parseApproval = spec.modal ? buildParseApprovalFromTui(spec.modal) : () => null;
+  const sessionIdRe = spec.sessionIdExtraction ? new RegExp(
+    spec.sessionIdExtraction.regex,
+    spec.sessionIdExtraction.flags ?? "i"
+  ) : null;
+  const sessionIdScope = spec.sessionIdExtraction?.scope ?? "tail";
+  return function parseSession(input) {
+    const status = detectStatus(input) ?? "idle";
+    const modal = parseApproval(input);
+    const text = pickInputText(input, scope);
+    const lines = splitLines(text);
+    const messages = [];
+    let seenFirstRoleLine = !stripLeadingChrome;
+    for (const raw of lines) {
+      const line = raw;
+      if (line.trim() === "") {
+        continue;
+      }
+      let isChrome = false;
+      for (const cre of chromeRes) {
+        if (cre.test(line)) {
+          isChrome = true;
+          break;
+        }
+      }
+      if (isChrome) continue;
+      const userMatch = userRe ? line.match(userRe) : null;
+      const toolMatch = toolRe ? line.match(toolRe) : null;
+      const assistMatch = line.match(assistantRe);
+      if (userMatch) {
+        seenFirstRoleLine = true;
+        const content = (userMatch[1] ?? userMatch[0]).trim();
+        if (content) messages.push({ role: "user", kind: "standard", content });
+        continue;
+      }
+      if (toolMatch) {
+        seenFirstRoleLine = true;
+        if (toolSkip) continue;
+        const content = (toolMatch[1] ?? toolMatch[0]).trim();
+        if (content) messages.push({ role: "assistant", kind: "tool", content });
+        continue;
+      }
+      if (assistMatch) {
+        seenFirstRoleLine = true;
+        const content = (assistMatch[1] ?? assistMatch[0]).trim();
+        if (content) messages.push({ role: "assistant", kind: "standard", content });
+        continue;
+      }
+      if (!seenFirstRoleLine) continue;
+      if (requireIndentForContinuation && !/^\s/.test(line)) continue;
+      const last = messages[messages.length - 1];
+      if (!last) continue;
+      const cont = line.replace(/^\s+/, "");
+      if (cont) last.content = last.content ? `${last.content}
+${cont}` : cont;
+    }
+    const result = {
+      status,
+      messages,
+      activeModal: modal,
+      modal,
+      parsedStatus: status
+    };
+    if (sessionIdRe) {
+      const haystack = stripAnsi2(pickInputText(input, sessionIdScope));
+      const match = haystack.match(sessionIdRe);
+      const captured = match?.[1]?.trim();
+      if (captured) result.providerSessionId = captured;
+    }
+    return result;
+  };
+}
+var ANSI_RE, OSC_RE;
+var init_parse_session = __esm({
+  "src/providers/sdk/v1/builders/cli/parse-session.ts"() {
+    "use strict";
+    init_detect_status();
+    init_parse_approval();
+    ANSI_RE = /\x1b\[[0-?]*[ -/]*[@-~]/g;
+    OSC_RE = /\x1b\][^\x07\x1b\n]*(?:\x07|\x1b\\|(?=\n|$))/g;
+  }
+});
+
+// src/cli-adapters/cli-script-runner.ts
+function summarizeInput(input) {
+  const screenText = typeof input?.screenText === "string" ? input.screenText : "";
+  const rawBuffer = typeof input?.rawBuffer === "string" ? input.rawBuffer : "";
+  const tail = typeof input?.tail === "string" ? input.tail : "";
+  return {
+    screenTextLen: screenText.length,
+    rawBufferLen: rawBuffer.length,
+    tailLen: tail.length,
+    isWaitingForResponse: typeof input?.isWaitingForResponse === "boolean" ? input.isWaitingForResponse : void 0,
+    screenTextHead: screenText ? screenText.slice(0, 200) : void 0
+  };
+}
+function summarizeResult(result) {
+  try {
+    const json = JSON.stringify(result);
+    return json && json.length > 400 ? `${json.slice(0, 400)}\u2026[truncated ${json.length - 400}]` : json ?? "undefined";
+  } catch (e) {
+    return `<unserializable: ${e?.message || e}>`;
+  }
+}
+var TRACE_RING_CAPACITY, DEFAULT_SCRIPT_CALL_BUDGET_MS, BUDGET_WARN_THROTTLE_MS, CliScriptRunner;
+var init_cli_script_runner = __esm({
+  "src/cli-adapters/cli-script-runner.ts"() {
     "use strict";
     init_logger();
-    init_provider_cli_parse();
     init_provider_cli_shared();
-    SCRIPT_STATUS_DEBOUNCE_MS = 3e3;
-    MAX_FINISH_RETRIES = 2;
-    FINISH_RETRY_DELAY_MS = 300;
-    MAX_TRACE_ENTRIES = 250;
-    APPROVAL_EXIT_TIMEOUT_MS = 6e4;
-    IDLE_CONFIRMATION_GRACE_MS = 2e3;
-    CliStateEngine = class {
-      constructor(provider, runner, transport, callbacks, timeouts) {
-        this.provider = provider;
-        this.runner = runner;
-        this.transport = transport;
-        this.callbacks = callbacks;
-        this.timeouts = timeouts;
+    init_detect_status();
+    init_parse_approval();
+    init_parse_session();
+    TRACE_RING_CAPACITY = 64;
+    DEFAULT_SCRIPT_CALL_BUDGET_MS = 50;
+    BUDGET_WARN_THROTTLE_MS = 3e4;
+    CliScriptRunner = class {
+      scripts = {};
+      scriptState = null;
+      _parseErrorMessage = null;
+      cliType;
+      sdk = {};
+      invocationTrace = [];
+      /** Per-invocation wall-clock budget (ms). Configurable via setScriptCallBudget. */
+      scriptCallBudgetMs = DEFAULT_SCRIPT_CALL_BUDGET_MS;
+      /** Last WARN emit time per scriptName, used to throttle repeated budget violations. */
+      lastBudgetWarnAt = /* @__PURE__ */ new Map();
+      constructor(cliType) {
+        this.cliType = cliType;
+      }
+      /** Returns the most-recent script invocation traces (oldest → newest). */
+      getInvocationTrace() {
+        return this.invocationTrace.slice();
+      }
+      /** Clear the trace ring — used by tests and after PTY reset. */
+      clearInvocationTrace() {
+        this.invocationTrace = [];
       }
-      // ── Status ───────────────────────────────────────
-      currentStatus = "starting";
-      isWaitingForResponse = false;
-      currentTurnScope = null;
-      activeModal = null;
-      // ── Approval ─────────────────────────────────────
-      lastApprovalResolvedAt = 0;
-      lastResolvedModalMessage = "";
       /**
-       * Monotonic counter bumped every time the FSM *enters* waiting_approval
-       * with a freshly captured modal (see `applyWaitingApproval`). It is the
-       * single discriminator between "the same approval re-observed across TUI
-       * paint flaps" and "a genuinely new, distinct approval".
-       *
-       * The message-equality cooldown below (`lastResolvedModalMessage`) cannot
-       * tell these apart on its own: claude-cli routinely presents consecutive
-       * approvals whose modal message text is identical (e.g. two back-to-back
-       * Bash-command prompts). When that second approval arrived inside
-       * `approvalCooldown`, the message-equality guard silently swallowed the
-       * key write and the approval stuck forever — fatal under auto-approval.
+       * Configure the wall-clock budget (ms) applied to every script invocation.
        *
-       * `approvalEntrySeq` increments on every fresh entry; `lastResolvedEntrySeq`
-       * records which entry the cooldown belongs to. We only short-circuit the
-       * write when we are still resolving *that same* entry — a new entry (new
-       * seq) is always a real, distinct approval and must be written.
-       */
-      approvalEntrySeq = 0;
-      lastResolvedEntrySeq = -1;
-      /**
-       * When the engine previously held a modal but the latest parse failed
-       * to extract one, we record the timestamp here and only drop the modal
-       * after the configured `approvalCooldown` to avoid flapping between
-       * waiting_approval and generating on every Claude TUI redraw — that
-       * flapping is what fed auto-approve a fresh modal signature on each
-       * paint and made the engine type "1" repeatedly into the prompt.
+       * Out-of-range or non-finite values are clamped to [1, 5000] and the
+       * default (50ms) is used as a fallback. The budget is enforced per-call,
+       * not aggregated — it does not abort a runaway script (Node CJS cannot
+       * interrupt synchronous code without a worker thread). Instead, an
+       * exceeded budget flags the trace entry with `timedOut: true` and emits
+       * a throttled WARN naming the script and elapsed time so an operator
+       * can identify which provider is hanging the settle loop.
        */
-      modalLostAt = 0;
-      approvalExitTimeout = null;
-      // ── Response tracking ────────────────────────────
-      responseEpoch = 0;
-      submitPendingUntil = 0;
-      responseSettleIgnoreUntil = 0;
-      submitRetryUsed = false;
-      submitRetryPromptSnippet = "";
-      finishRetryCount = 0;
-      providerErrorMessage = null;
-      providerErrorReason = null;
-      // ── Timers ───────────────────────────────────────
-      settleTimer = null;
-      idleTimeout = null;
-      finishRetryTimer = null;
-      providerErrorRetryTimer = null;
-      providerErrorRetryKey = "";
-      // ── Debounce ─────────────────────────────────────
-      pendingScriptStatus = null;
-      pendingScriptStatusSince = 0;
-      pendingScriptStatusTimer = null;
-      // ── Idle candidate ───────────────────────────────
-      idleFinishCandidate = null;
-      // ── Idle confirmation grace ──────────────────────
-      /**
-       * `finishResponse` produces the `generating → idle` transition that
-       * coordinators interpret as "task complete". Some providers (antigravity-
-       * cli observed in the wild) briefly paint a screen that looks like an
-       * idle prompt between tool result frames while still actively running,
-       * which fired `response_finished` and broke completion semantics.
-       * We defer the actual idle transition by IDLE_CONFIRMATION_GRACE_MS and
-       * cancel it if the scripted detection re-detects generating during that
+      setScriptCallBudget(ms) {
+        if (typeof ms !== "number" || !Number.isFinite(ms)) {
+          this.scriptCallBudgetMs = DEFAULT_SCRIPT_CALL_BUDGET_MS;
+          return;
+        }
+        const clamped = Math.max(1, Math.min(5e3, Math.floor(ms)));
+        this.scriptCallBudgetMs = clamped;
+      }
+      /** Test/debug accessor — current effective budget in ms. */
+      getScriptCallBudgetMs() {
+        return this.scriptCallBudgetMs;
+      }
+      recordTrace(entry) {
+        this.invocationTrace.push(entry);
+        if (this.invocationTrace.length > TRACE_RING_CAPACITY) {
+          this.invocationTrace.splice(0, this.invocationTrace.length - TRACE_RING_CAPACITY);
+        }
+      }
+      // ─── Script lifecycle ─────────────────────────────
+      setScripts(scripts, providerTui) {
+        this.sdk = this.buildSdk(providerTui);
+        const tui = providerTui;
+        const enriched = { ...scripts };
+        if (typeof enriched.detectStatus !== "function" && this.sdk.declarativeDetectStatus) {
+          enriched.detectStatus = this.sdk.declarativeDetectStatus;
+        }
+        if (typeof enriched.parseApproval !== "function" && this.sdk.declarativeParseApproval) {
+          enriched.parseApproval = this.sdk.declarativeParseApproval;
+        }
+        if (typeof enriched.parseSession !== "function" && tui?.transcriptPty) {
+          try {
+            const synth = buildParseSessionFromTui({
+              spinner: tui.spinner,
+              settledPrompt: tui.settledPrompt,
+              modal: tui.modal,
+              dispatchOrder: tui.dispatchOrder,
+              transcriptPty: tui.transcriptPty
+            });
+            enriched.parseSession = ((input) => {
+              const out = synth(input);
+              return {
+                ...out,
+                messages: normalizeMessageIdentity(out.messages, out.status ?? "idle")
+              };
+            });
+          } catch (e) {
+            LOG.warn("CLI", `[${this.cliType}] buildParseSessionFromTui failed: ${e?.message || e}`);
+          }
+        }
+        this.scripts = enriched;
+        this._parseErrorMessage = null;
+        this.scriptState = typeof enriched.createState === "function" ? enriched.createState() ?? null : null;
+      }
+      buildSdk(providerTui) {
+        const tui = providerTui;
+        if (!tui) return {};
+        const sdk = {};
+        if (tui.spinner || tui.settledPrompt || tui.modal || tui.dispatchOrder) {
+          try {
+            sdk.declarativeDetectStatus = buildDetectStatusFromTui({
+              spinner: tui.spinner,
+              settledPrompt: tui.settledPrompt,
+              modal: tui.modal,
+              dispatchOrder: tui.dispatchOrder
+            });
+          } catch (e) {
+            LOG.warn("CLI", `[${this.cliType}] buildDetectStatusFromTui failed: ${e?.message || e}`);
+          }
+        }
+        if (tui.modal) {
+          try {
+            sdk.declarativeParseApproval = buildParseApprovalFromTui(tui.modal);
+          } catch (e) {
+            LOG.warn("CLI", `[${this.cliType}] buildParseApprovalFromTui failed: ${e?.message || e}`);
+          }
+        }
+        return sdk;
+      }
+      /** Reset per-session state — called when the PTY process exits. */
+      resetSessionState() {
+        this.scriptState = null;
+        this.invocationTrace = [];
+        this.lastBudgetWarnAt.clear();
+      }
+      // ─── Script access (for reflection and test patching) ────────────────────
+      /** Returns the live scripts object. Direct property assignment on this object
+       *  patches individual scripts without replacing others (used in tests). */
+      get cliScripts() {
+        return this.scripts;
+      }
+      // ─── Capability checks ────────────────────────────
+      hasDetectStatus() {
+        return typeof this.scripts.detectStatus === "function";
+      }
+      hasParseSession() {
+        return typeof this.scripts.parseSession === "function";
+      }
+      getScriptNames() {
+        return listCliScriptNames(this.scripts);
+      }
+      // ─── Error state ──────────────────────────────────
+      get parseErrorMessage() {
+        return this._parseErrorMessage;
+      }
+      clearParseError() {
+        this._parseErrorMessage = null;
+      }
+      // ─── Script invocation ────────────────────────────
+      detectStatus(input) {
+        if (!this.scripts.detectStatus) return null;
+        try {
+          return this.invoke("detectStatus", this.scripts.detectStatus, input);
+        } catch (e) {
+          LOG.warn("CLI", `[${this.cliType}] detectStatus error: ${e?.message || e}`);
+          return null;
+        }
+      }
+      parseApproval(input) {
+        if (!this.scripts.parseApproval) return null;
+        try {
+          return this.invoke(
+            "parseApproval",
+            this.scripts.parseApproval,
+            input
+          );
+        } catch (e) {
+          LOG.warn("CLI", `[${this.cliType}] parseApproval error: ${e?.message || e}`);
+          return null;
+        }
+      }
+      parseSession(input) {
+        if (!this.scripts.parseSession) {
+          this._parseErrorMessage = `${this.cliType} parseSession unavailable`;
+          return null;
+        }
+        try {
+          const result = this.invoke("parseSession", this.scripts.parseSession, input);
+          this._parseErrorMessage = null;
+          return result && typeof result === "object" ? result : null;
+        } catch (e) {
+          this._parseErrorMessage = e?.message || String(e);
+          LOG.warn("CLI", `[${this.cliType}] parseSession error: ${this._parseErrorMessage}`);
+          return null;
+        }
+      }
+      /**
+       * Invoke an arbitrary named script (e.g. setModel, openModelPicker).
+       * Throws if the script is not available.
+       */
+      invokeByName(name, input) {
+        const fn = this.scripts[name];
+        if (typeof fn !== "function") {
+          throw new Error(`CLI script '${name}' not available`);
+        }
+        return this.invoke(name, fn, input);
+      }
+      // ─── Internal ─────────────────────────────────────
+      invoke(scriptName, fn, input) {
+        const arity = fn.length;
+        const startedAt = Date.now();
+        const startedHr = typeof process !== "undefined" && typeof process.hrtime === "function" ? process.hrtime.bigint() : null;
+        let result;
+        try {
+          if (arity >= 3) {
+            result = fn(this.scriptState, input, this.sdk);
+          } else if (arity === 2) {
+            result = fn(this.scriptState, input);
+          } else {
+            result = fn(input);
+          }
+          const elapsedUs = startedHr ? Number((process.hrtime.bigint() - startedHr) / 1000n) : 0;
+          const timedOut = this.checkBudget(scriptName, elapsedUs);
+          this.recordTrace({
+            at: startedAt,
+            scriptName,
+            arity,
+            inputSummary: summarizeInput(input),
+            ok: true,
+            elapsedUs,
+            resultSummary: summarizeResult(result),
+            ...timedOut ? { timedOut: true } : {}
+          });
+          return result;
+        } catch (e) {
+          const elapsedUs = startedHr ? Number((process.hrtime.bigint() - startedHr) / 1000n) : 0;
+          const timedOut = this.checkBudget(scriptName, elapsedUs);
+          this.recordTrace({
+            at: startedAt,
+            scriptName,
+            arity,
+            inputSummary: summarizeInput(input),
+            ok: false,
+            elapsedUs,
+            error: e?.message ? String(e.message).slice(0, 400) : String(e).slice(0, 400),
+            ...timedOut ? { timedOut: true } : {}
+          });
+          throw e;
+        }
+      }
+      /**
+       * Returns true when `elapsedUs` exceeded the configured budget. On the
+       * first violation per script (or after the throttle window expires) we
+       * emit a single WARN so the operator learns which provider is slow.
+       *
+       * We deliberately throttle per-scriptName so a chronically-slow
+       * detectStatus doesn't spam the log on every PTY frame settle.
+       */
+      checkBudget(scriptName, elapsedUs) {
+        const budgetUs = this.scriptCallBudgetMs * 1e3;
+        if (elapsedUs <= budgetUs) return false;
+        const now = Date.now();
+        const last = this.lastBudgetWarnAt.get(scriptName) ?? 0;
+        if (now - last >= BUDGET_WARN_THROTTLE_MS) {
+          this.lastBudgetWarnAt.set(scriptName, now);
+          LOG.warn(
+            "CLI",
+            `[${this.cliType}] script ${scriptName} took ${elapsedUs}us, budget ${budgetUs}us`
+          );
+        }
+        return true;
+      }
+    };
+  }
+});
+
+// src/cli-adapters/provider-cli-parse.ts
+function sliceFromOffset(text, start) {
+  if (!text) return "";
+  if (!Number.isFinite(start) || start <= 0) return text;
+  if (start >= text.length) return "";
+  return text.slice(start);
+}
+function normalizeCliParsedMessages(parsedMessages, _options) {
+  return Array.isArray(parsedMessages) ? parsedMessages : [];
+}
+function buildCliParseInput(options) {
+  const {
+    accumulatedBuffer,
+    accumulatedRawBuffer,
+    recentOutputBuffer,
+    terminalScreenText,
+    workingDir,
+    providerSessionId,
+    historySessionId,
+    baseMessages,
+    partialResponse,
+    isWaitingForResponse,
+    scope,
+    runtimeSettings,
+    spawnAt
+  } = options;
+  const buffer = scope ? sliceFromOffset(accumulatedBuffer, scope.bufferStart) : accumulatedBuffer;
+  const rawBuffer = scope ? sliceFromOffset(accumulatedRawBuffer, scope.rawBufferStart) : accumulatedRawBuffer;
+  const screenText = terminalScreenText;
+  const recentBuffer = buffer.slice(-1e3) || recentOutputBuffer;
+  return {
+    buffer,
+    rawBuffer,
+    recentBuffer,
+    screenText,
+    workspace: workingDir,
+    workingDir,
+    providerSessionId,
+    historySessionId,
+    screen: buildCliScreenSnapshot(screenText),
+    bufferScreen: buildCliScreenSnapshot(buffer),
+    recentScreen: buildCliScreenSnapshot(recentBuffer),
+    messages: [...baseMessages],
+    partialResponse,
+    isWaitingForResponse,
+    promptText: scope?.prompt || "",
+    settings: { ...runtimeSettings },
+    ...typeof spawnAt === "number" && spawnAt > 0 ? { spawnAt } : {}
+  };
+}
+function summarizeCliTraceText(text, max = 800) {
+  const value = sanitizeTerminalText(String(text || ""));
+  if (value.length <= max) return value;
+  return `\u2026${value.slice(-max)}`;
+}
+var init_provider_cli_parse = __esm({
+  "src/cli-adapters/provider-cli-parse.ts"() {
+    "use strict";
+    init_provider_cli_shared();
+  }
+});
+
+// src/cli-adapters/cli-state-engine.ts
+var SCRIPT_STATUS_DEBOUNCE_MS, MAX_FINISH_RETRIES, FINISH_RETRY_DELAY_MS, MAX_TRACE_ENTRIES, APPROVAL_EXIT_TIMEOUT_MS, IDLE_CONFIRMATION_GRACE_MS, CliStateEngine;
+var init_cli_state_engine = __esm({
+  "src/cli-adapters/cli-state-engine.ts"() {
+    "use strict";
+    init_logger();
+    init_provider_cli_parse();
+    init_provider_cli_shared();
+    SCRIPT_STATUS_DEBOUNCE_MS = 3e3;
+    MAX_FINISH_RETRIES = 2;
+    FINISH_RETRY_DELAY_MS = 300;
+    MAX_TRACE_ENTRIES = 250;
+    APPROVAL_EXIT_TIMEOUT_MS = 6e4;
+    IDLE_CONFIRMATION_GRACE_MS = 2e3;
+    CliStateEngine = class {
+      constructor(provider, runner, transport, callbacks, timeouts) {
+        this.provider = provider;
+        this.runner = runner;
+        this.transport = transport;
+        this.callbacks = callbacks;
+        this.timeouts = timeouts;
+      }
+      // ── Status ───────────────────────────────────────
+      currentStatus = "starting";
+      isWaitingForResponse = false;
+      currentTurnScope = null;
+      activeModal = null;
+      // ── Approval ─────────────────────────────────────
+      lastApprovalResolvedAt = 0;
+      lastResolvedModalMessage = "";
+      /**
+       * Monotonic counter bumped every time the FSM *enters* waiting_approval
+       * with a freshly captured modal (see `applyWaitingApproval`). It is the
+       * single discriminator between "the same approval re-observed across TUI
+       * paint flaps" and "a genuinely new, distinct approval".
+       *
+       * The message-equality cooldown below (`lastResolvedModalMessage`) cannot
+       * tell these apart on its own: claude-cli routinely presents consecutive
+       * approvals whose modal message text is identical (e.g. two back-to-back
+       * Bash-command prompts). When that second approval arrived inside
+       * `approvalCooldown`, the message-equality guard silently swallowed the
+       * key write and the approval stuck forever — fatal under auto-approval.
+       *
+       * `approvalEntrySeq` increments on every fresh entry; `lastResolvedEntrySeq`
+       * records which entry the cooldown belongs to. We only short-circuit the
+       * write when we are still resolving *that same* entry — a new entry (new
+       * seq) is always a real, distinct approval and must be written.
+       */
+      approvalEntrySeq = 0;
+      lastResolvedEntrySeq = -1;
+      /**
+       * When the engine previously held a modal but the latest parse failed
+       * to extract one, we record the timestamp here and only drop the modal
+       * after the configured `approvalCooldown` to avoid flapping between
+       * waiting_approval and generating on every Claude TUI redraw — that
+       * flapping is what fed auto-approve a fresh modal signature on each
+       * paint and made the engine type "1" repeatedly into the prompt.
+       */
+      modalLostAt = 0;
+      approvalExitTimeout = null;
+      // ── Response tracking ────────────────────────────
+      responseEpoch = 0;
+      submitPendingUntil = 0;
+      responseSettleIgnoreUntil = 0;
+      submitRetryUsed = false;
+      submitRetryPromptSnippet = "";
+      finishRetryCount = 0;
+      providerErrorMessage = null;
+      providerErrorReason = null;
+      // ── Timers ───────────────────────────────────────
+      settleTimer = null;
+      idleTimeout = null;
+      finishRetryTimer = null;
+      providerErrorRetryTimer = null;
+      providerErrorRetryKey = "";
+      // ── Debounce ─────────────────────────────────────
+      pendingScriptStatus = null;
+      pendingScriptStatusSince = 0;
+      pendingScriptStatusTimer = null;
+      // ── Idle candidate ───────────────────────────────
+      idleFinishCandidate = null;
+      // ── Idle confirmation grace ──────────────────────
+      /**
+       * `finishResponse` produces the `generating → idle` transition that
+       * coordinators interpret as "task complete". Some providers (antigravity-
+       * cli observed in the wild) briefly paint a screen that looks like an
+       * idle prompt between tool result frames while still actively running,
+       * which fired `response_finished` and broke completion semantics.
+       * We defer the actual idle transition by IDLE_CONFIRMATION_GRACE_MS and
+       * cancel it if the scripted detection re-detects generating during that
        * window — a true completion stays idle for many seconds, so a 2-second
        * grace is sufficient to filter the paint blip.
        */
@@ -19529,595 +20118,6 @@ ${lastSnapshot}`;
   }
 });
 
-// src/providers/spec/evaluator.ts
-var evaluator_exports = {};
-__export(evaluator_exports, {
-  evaluateCondition: () => evaluateCondition,
-  extractButtonsFromRule: () => extractButtonsFromRule,
-  extractTitle: () => extractTitle,
-  lastContiguousNumberedBlock: () => lastContiguousNumberedBlock,
-  resolveSections: () => resolveSections,
-  sectionText: () => sectionText
-});
-function resolveSize(size, total) {
-  if (size === void 0) return 0;
-  if (typeof size === "number") return Math.max(0, Math.min(total, size));
-  const m = /^(\d+(?:\.\d+)?)%$/.exec(size);
-  if (!m) return 0;
-  const pct = Number(m[1]);
-  return Math.max(0, Math.min(total, Math.round(total * pct / 100)));
-}
-function resolveSections(sectionsObj, lines) {
-  const total = lines.length;
-  const anchored = /* @__PURE__ */ new Map();
-  const sectionEntries = Object.entries(sectionsObj);
-  for (const [id, sec] of sectionEntries) {
-    let from = 0;
-    let to = total;
-    if (sec.anchor !== void 0) {
-      try {
-        const anchorPatterns = Array.isArray(sec.anchor) ? sec.anchor : [sec.anchor];
-        const sharedCtx = Array.isArray(sec.anchor_context) ? null : sec.anchor_context ?? null;
-        const ctxList = Array.isArray(sec.anchor_context) ? sec.anchor_context : anchorPatterns.map(() => sharedCtx);
-        const candidates = anchorPatterns.map((pattern, k) => {
-          const ctx = ctxList[k] ?? null;
-          return {
-            re: new RegExp(pattern, sec.anchor_flags ?? ""),
-            prevRe: ctx?.prev !== void 0 ? new RegExp(ctx.prev, ctx.prev_flags ?? "") : null,
-            nextRe: ctx?.next !== void 0 ? new RegExp(ctx.next, ctx.next_flags ?? "") : null
-          };
-        });
-        const matchesCandidate = (c, i) => c.re.test(lines[i]) && (c.prevRe === null || i > 0 && c.prevRe.test(lines[i - 1])) && (c.nextRe === null || i < total - 1 && c.nextRe.test(lines[i + 1]));
-        let idx = -1;
-        for (const c of candidates) {
-          let candIdx = -1;
-          if (sec.anchor_last) {
-            for (let i = total - 1; i >= 0; i--) {
-              if (matchesCandidate(c, i)) {
-                candIdx = i;
-                break;
-              }
-            }
-          } else {
-            for (let i = 0; i < total; i++) {
-              if (matchesCandidate(c, i)) {
-                candIdx = i;
-                break;
-              }
-            }
-          }
-          if (candIdx !== -1 && (idx === -1 || candIdx < idx)) idx = candIdx;
-        }
-        if (idx !== -1) {
-          from = idx;
-          to = total;
-          if (sec.until_regex !== void 0) {
-            try {
-              const ure = new RegExp(sec.until_regex, sec.until_regex_flags ?? "");
-              const end = lines.findIndex((l, i) => i > idx && ure.test(l));
-              if (end !== -1) to = end;
-            } catch {
-            }
-          } else if (sec.lines !== void 0) {
-            to = Math.min(total, from + sec.lines);
-          }
-        }
-      } catch {
-      }
-    } else if (sec.from_top !== void 0) {
-      from = resolveSize(sec.from_top, total);
-      to = total;
-    } else if (sec.from_bottom !== void 0) {
-      const sz = resolveSize(sec.from_bottom, total);
-      from = total - sz;
-      to = total;
-    }
-    anchored.set(id, { fromLine: from, toLine: to });
-  }
-  const resolved = [];
-  for (const [id, sec] of sectionEntries) {
-    let { fromLine, toLine } = anchored.get(id);
-    if (sec.until !== void 0) {
-      if (sec.until.startsWith("^")) {
-        try {
-          const ure = new RegExp(sec.until);
-          const end = lines.findIndex((l, i) => i > fromLine && ure.test(l));
-          if (end !== -1) toLine = end;
-        } catch {
-        }
-      } else {
-        const target = anchored.get(sec.until);
-        if (target) toLine = target.fromLine;
-      }
-    }
-    if (toLine < fromLine) toLine = fromLine;
-    const text = lines.slice(fromLine, toLine).join("\n");
-    resolved.push({ id, fromLine, toLine, text });
-  }
-  return resolved;
-}
-function sectionText(sections, sectionId, fullScreen) {
-  if (!sectionId) return fullScreen;
-  const found = sections.find((s2) => s2.id === sectionId);
-  return found ? found.text : "";
-}
-function isRegexCondition(c) {
-  return "matches" in c;
-}
-function isChangedCondition(c) {
-  return "cursor_above" in c && "changed" in c;
-}
-function isAllCondition(c) {
-  return "all" in c;
-}
-function isAnyCondition(c) {
-  return "any" in c;
-}
-function evaluateCondition(cond, sections, fullScreen, cursor, prevLines, trace, stateId) {
-  if (isAllCondition(cond)) {
-    for (const child of cond.all) {
-      if (!evaluateCondition(child, sections, fullScreen, cursor, prevLines, trace, stateId)) {
-        return false;
-      }
-    }
-    return true;
-  }
-  if (isAnyCondition(cond)) {
-    for (const child of cond.any) {
-      if (evaluateCondition(child, sections, fullScreen, cursor, prevLines, trace, stateId)) {
-        return true;
-      }
-    }
-    return false;
-  }
-  if (isChangedCondition(cond)) {
-    if (!cursor || !prevLines || prevLines.length === 0) return false;
-    const curLines = fullScreen.split("\n");
-    const startRow = Math.max(0, cursor.row - cond.cursor_above);
-    const endRow = cursor.row;
-    const currentSlice = curLines.slice(startRow, endRow).join("\n");
-    const prevSlice = prevLines.slice(startRow, endRow).join("\n");
-    const didChange = currentSlice !== prevSlice;
-    const result = cond.changed ? didChange : !didChange;
-    const stableSuffix = cond.stable_ms != null ? ` stable_ms=${cond.stable_ms}` : "";
-    trace.push({
-      kind: result ? "state_match" : "state_skip",
-      text: `state[${stateId}] changed cond cursor_above=${cond.cursor_above} rows[${startRow},${endRow}) changed=${didChange} expected=${cond.changed}${stableSuffix} result=${result}`
-    });
-    return result;
-  }
-  if (isRegexCondition(cond)) {
-    const haystack = sectionText(sections, cond.section, fullScreen);
-    let matched = false;
-    try {
-      const re = new RegExp(cond.matches, cond.flags ?? "i");
-      matched = re.test(haystack);
-    } catch {
-      matched = false;
-    }
-    if (!matched) {
-      trace.push({ kind: "state_skip", text: `state[${stateId}] regex cond ${cond.section ?? "*"}~/${cond.matches}/ no match` });
-      return false;
-    }
-    if (cursor !== void 0) {
-      if (cond.cursor_row_min !== void 0 && cursor.row < cond.cursor_row_min) {
-        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor row ${cursor.row} < cursor_row_min ${cond.cursor_row_min}` });
-        return false;
-      }
-      if (cond.cursor_row_max !== void 0 && cursor.row > cond.cursor_row_max) {
-        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor row ${cursor.row} > cursor_row_max ${cond.cursor_row_max}` });
-        return false;
-      }
-      if (cond.cursor_col_min !== void 0 && cursor.col < cond.cursor_col_min) {
-        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor col ${cursor.col} < cursor_col_min ${cond.cursor_col_min}` });
-        return false;
-      }
-      if (cond.cursor_col_max !== void 0 && cursor.col > cond.cursor_col_max) {
-        trace.push({ kind: "state_skip", text: `state[${stateId}] cursor col ${cursor.col} > cursor_col_max ${cond.cursor_col_max}` });
-        return false;
-      }
-    }
-    trace.push({ kind: "state_match", text: `state[${stateId}] regex cond ${cond.section ?? "*"}~/${cond.matches}/ matched${cursor !== void 0 ? ` cursor=(${cursor.row},${cursor.col})` : ""}` });
-    return true;
-  }
-  return false;
-}
-function extractTitle(rule, sections, fullScreen) {
-  const hay = sectionText(sections, rule.section, fullScreen);
-  if (!hay) return null;
-  if (rule.first_line) {
-    const lines = hay.split("\n");
-    for (const line of lines) {
-      const stripped = line.trim();
-      if (stripped && !/^[─╌═─\s]+$/.test(stripped)) {
-        return stripped;
-      }
-    }
-    return null;
-  }
-  if (rule.regex) {
-    try {
-      const re = new RegExp(rule.regex, rule.flags ?? "i");
-      const m = re.exec(hay);
-      if (m) return (m[1] ?? m[0]).trim();
-    } catch {
-    }
-  }
-  return null;
-}
-function compilePattern(ref) {
-  const flags = ref.flags ?? "gm";
-  return new RegExp(ref.pattern, flags.includes("g") ? flags : flags + "g");
-}
-function compileLinePattern(ref) {
-  const flags = (ref.flags ?? "m").replace(/g/g, "");
-  return new RegExp(ref.pattern, flags);
-}
-function extractButtonsFromRule(rule, hay) {
-  const keyTemplate = rule.key_for_index;
-  const continuationLines = rule.continuation_lines ?? false;
-  const buttons = [];
-  if (continuationLines) {
-    const re = compileLinePattern(rule);
-    const lines = hay.split("\n");
-    for (let i = 0; i < lines.length; i += 1) {
-      const m = re.exec(lines[i]);
-      if (!m) continue;
-      const idx = Number(m[1]);
-      let label = String(m[2] ?? "").trim();
-      if (!Number.isFinite(idx) || idx <= 0 || !label) continue;
-      const current = hasCursorMarker(lines[i]);
-      let j = i + 1;
-      while (j < lines.length) {
-        const next = lines[j];
-        if (!next.trim()) break;
-        if (re.test(next)) break;
-        if (!/^\s+/.test(next)) break;
-        label += " " + next.trim();
-        j += 1;
-      }
-      const key = keyTemplate.replace(/\{index\}/g, String(idx));
-      buttons.push({ index: idx, label, key, current });
-      i = j - 1;
-    }
-  } else {
-    const re = compilePattern(rule);
-    let m;
-    while ((m = re.exec(hay)) !== null) {
-      const idx = Number(m[1]);
-      const label = String(m[2] ?? "").trim();
-      if (!Number.isFinite(idx) || idx <= 0 || !label) continue;
-      const key = keyTemplate.replace(/\{index\}/g, String(idx));
-      buttons.push({ index: idx, label, key, current: hasCursorMarker(m[0]) });
-    }
-  }
-  const block2 = lastContiguousNumberedBlock(buttons);
-  block2.sort((a, b) => a.index - b.index);
-  return block2;
-}
-function lastContiguousNumberedBlock(entries) {
-  if (entries.length <= 1) return entries.slice();
-  let start = entries.length - 1;
-  for (let i = entries.length - 1; i > 0; i -= 1) {
-    if (entries[i - 1].index === entries[i].index - 1) start = i - 1;
-    else break;
-  }
-  return entries.slice(start);
-}
-function hasCursorMarker(text) {
-  return /^\s*[❯›>]/.test(text);
-}
-var init_evaluator = __esm({
-  "src/providers/spec/evaluator.ts"() {
-    "use strict";
-  }
-});
-
-// src/providers/spec/fsm-types.ts
-function isV4Spec(raw) {
-  return !!raw && typeof raw === "object" && raw.$schema === "adhdev:cli/spec@4";
-}
-function initialState(spec) {
-  return spec.states.find((s2) => s2.initial) ?? spec.states[0];
-}
-function stateById(spec, id) {
-  return spec.states.find((s2) => s2.id === id);
-}
-function outgoingTransitions(spec, stateId) {
-  const matches = spec.transitions.filter((t) => {
-    if (t.from === "*") return true;
-    if (Array.isArray(t.from)) return t.from.includes(stateId);
-    return t.from === stateId;
-  });
-  return matches.map((t, i) => ({ t, i })).sort((a, b) => (b.t.priority ?? 0) - (a.t.priority ?? 0) || a.i - b.i).map((x) => x.t);
-}
-function statusForState(state) {
-  if (state.status) return state.status;
-  if (state.modal) return "approval";
-  if (state.id === "busy" || state.id === "generating") return "generating";
-  return "idle";
-}
-function modalKindForState(state) {
-  if (state.modal_kind) return state.modal_kind;
-  if (state.modal) return "approval";
-  return null;
-}
-var init_fsm_types = __esm({
-  "src/providers/spec/fsm-types.ts"() {
-    "use strict";
-  }
-});
-
-// src/providers/spec/fsm-evaluator.ts
-var fsm_evaluator_exports = {};
-__export(fsm_evaluator_exports, {
-  evaluateConditionPreview: () => evaluateConditionPreview,
-  evaluateFsm: () => evaluateFsm
-});
-function regionKey(cursorAbove) {
-  return cursorAbove && cursorAbove > 0 ? cursorAbove : WHOLE_SCREEN;
-}
-function isRegex(c) {
-  return "matches" in c;
-}
-function isChanged(c) {
-  return "cursor_above" in c && "changed" in c;
-}
-function isElapsed(c) {
-  return "elapsed_ms" in c;
-}
-function isStable(c) {
-  return "stable_ms" in c;
-}
-function isAll(c) {
-  return "all" in c;
-}
-function isAny(c) {
-  return "any" in c;
-}
-function isNot(c) {
-  return "not" in c;
-}
-function evalCond(cond, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId) {
-  if (isAll(cond)) {
-    const children = cond.all.map((c) => evalCond(c, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId));
-    const result = children.every((c) => c.result);
-    const remainingMs = result ? 0 : Math.max(0, ...children.filter((c) => !c.result).map((c) => c.remainingMs ?? 0));
-    return { kind: "all", result, detail: `all(${children.length})`, remainingMs, children };
-  }
-  if (isAny(cond)) {
-    const children = cond.any.map((c) => evalCond(c, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId));
-    const result = children.some((c) => c.result);
-    const pending = children.filter((c) => !c.result).map((c) => c.remainingMs ?? Infinity);
-    const remainingMs = result ? 0 : pending.length ? Math.min(...pending) : 0;
-    return { kind: "any", result, detail: `any(${children.length})`, remainingMs: Number.isFinite(remainingMs) ? remainingMs : 0, children };
-  }
-  if (isNot(cond)) {
-    const child = evalCond(cond.not, sections, fullScreen, cursor, prevLines, clock, legacyTrace, stateId);
-    return { kind: "not", result: !child.result, detail: `not`, remainingMs: 0, children: [child] };
-  }
-  if (isElapsed(cond)) {
-    const age = clock.now - clock.stateEnteredAt;
-    const result = age >= cond.elapsed_ms;
-    const remainingMs = result ? 0 : cond.elapsed_ms - age;
-    return { kind: "elapsed", result, detail: `elapsed ${age}ms / ${cond.elapsed_ms}ms`, remainingMs };
-  }
-  if (isStable(cond)) {
-    const key = regionKey(cond.cursor_above);
-    const lastChanged = clock.regionLastChangedAt.get(key) ?? clock.stateEnteredAt;
-    const stableFor = clock.now - lastChanged;
-    const result = stableFor >= cond.stable_ms;
-    const remainingMs = result ? 0 : cond.stable_ms - stableFor;
-    const where = key === WHOLE_SCREEN ? "screen" : `cursor_above=${cond.cursor_above}`;
-    return { kind: "stable", result, detail: `stable ${where} ${stableFor}ms / ${cond.stable_ms}ms`, remainingMs };
-  }
-  if (isRegex(cond) || isChanged(cond)) {
-    const result = evaluateCondition(cond, sections, fullScreen, cursor, prevLines, legacyTrace, stateId);
-    const kind = isRegex(cond) ? "regex" : "changed";
-    const detail = isRegex(cond) ? `${cond.section ?? "*"}~/${cond.matches}/` : `cursor_above=${cond.cursor_above} changed=${cond.changed}`;
-    let matchedText;
-    if (result && isRegex(cond)) {
-      try {
-        const hay = sectionText(sections, cond.section, fullScreen);
-        const re = new RegExp(cond.matches, cond.flags ?? "i");
-        const m = re.exec(hay);
-        if (m && m[0]) matchedText = m[0].replace(/\s+/g, " ").trim().slice(0, 160);
-      } catch {
-      }
-    }
-    return matchedText ? { kind, result, detail, matchedText } : { kind, result, detail };
-  }
-  return { kind: "all", result: false, detail: "unknown condition" };
-}
-function fromLabel(t) {
-  const from = Array.isArray(t.from) ? t.from.join("|") : t.from;
-  return t.label ?? `${from}\u2192${t.to}`;
-}
-function evaluateFsm(spec, currentStateId, screenText, cursor, prevLines, clock) {
-  const legacyTrace = [];
-  const lines = screenText.split("\n").map((l) => l.endsWith("\r") ? l.slice(0, -1) : l);
-  const cleanScreen = lines.join("\n");
-  const sections = resolveSections(spec.sections ?? {}, lines);
-  const outgoing = outgoingTransitions(spec, currentStateId);
-  const transitions = [];
-  let fired = null;
-  for (const t of outgoing) {
-    const holdMs = t.min_hold_ms ?? 0;
-    const heldFor = clock.now - clock.stateEnteredAt;
-    const holdSatisfied = heldFor >= holdMs;
-    const holdRemainingMs = holdSatisfied ? 0 : holdMs - heldFor;
-    let cond;
-    let condResult = true;
-    if (t.when) {
-      cond = evalCond(t.when, sections, cleanScreen, cursor, prevLines, clock, legacyTrace, `${currentStateId}\u2192${t.to}`);
-      condResult = cond.result;
-    }
-    const fires = holdSatisfied && condResult;
-    const te = {
-      to: t.to,
-      label: fromLabel(t),
-      eligible: true,
-      holdSatisfied,
-      holdRemainingMs,
-      condResult,
-      cond,
-      fires,
-      priority: t.priority ?? 0
-    };
-    transitions.push(te);
-    if (fires && !fired) fired = te;
-  }
-  if (fired && !stateById(spec, fired.to)) {
-    legacyTrace.push({ kind: "state_skip", text: `transition target ${fired.to} not found` });
-    fired = null;
-  }
-  return { sections, transitions, fired, trace: legacyTrace };
-}
-function evaluateConditionPreview(cond, sections, screenText, cursor) {
-  const lines = screenText.split("\n").map((l) => l.endsWith("\r") ? l.slice(0, -1) : l);
-  const cleanScreen = lines.join("\n");
-  const resolved = resolveSections(sections ?? {}, lines);
-  const clock = { now: 0, stateEnteredAt: 0, regionLastChangedAt: /* @__PURE__ */ new Map() };
-  return evalCond(cond, resolved, cleanScreen, cursor, void 0, clock, [], "preview");
-}
-var WHOLE_SCREEN;
-var init_fsm_evaluator = __esm({
-  "src/providers/spec/fsm-evaluator.ts"() {
-    "use strict";
-    init_evaluator();
-    init_fsm_types();
-    WHOLE_SCREEN = -1;
-  }
-});
-
-// src/providers/spec/fsm-loader.ts
-var fsm_loader_exports = {};
-__export(fsm_loader_exports, {
-  loadFsmSpec: () => loadFsmSpec,
-  validateFsmSpec: () => validateFsmSpec
-});
-import * as fs10 from "fs";
-function loadFsmSpec(sourcePath) {
-  let raw;
-  try {
-    raw = JSON.parse(fs10.readFileSync(sourcePath, "utf8"));
-  } catch (err) {
-    return { ok: false, errors: [`Failed to read/parse spec: ${err.message}`], sourcePath };
-  }
-  const errors = validateFsmSpec(raw);
-  if (errors.length) return { ok: false, errors, sourcePath };
-  return { ok: true, spec: raw, sourcePath };
-}
-function validateFsmSpec(raw) {
-  const errs = [];
-  if (!isV4Spec(raw)) return ['$schema must be "adhdev:cli/spec@4"'];
-  const spec = raw;
-  if (!spec.id) errs.push("id is required");
-  if (!spec.binary) errs.push("binary is required");
-  if (!spec.send_message?.submit_key) errs.push("send_message.submit_key is required");
-  if (spec.pre_launch_trust !== void 0) {
-    const t = spec.pre_launch_trust;
-    if (!t || typeof t !== "object" || Array.isArray(t)) {
-      errs.push("pre_launch_trust must be an object");
-    } else {
-      if (typeof t.settings_path !== "string" || !t.settings_path) errs.push("pre_launch_trust.settings_path is required");
-      if (typeof t.key !== "string" || !t.key) errs.push("pre_launch_trust.key is required");
-    }
-  }
-  if (spec.refocus_when_stalled_ms !== void 0) {
-    if (typeof spec.refocus_when_stalled_ms !== "number" || !(spec.refocus_when_stalled_ms > 0)) {
-      errs.push("refocus_when_stalled_ms must be a positive number");
-    } else if (!Array.isArray(spec.send_on_spawn) || spec.send_on_spawn.length === 0) {
-      errs.push("refocus_when_stalled_ms requires send_on_spawn (the wake sequence to re-inject)");
-    }
-  }
-  if (!Array.isArray(spec.states) || spec.states.length === 0) {
-    errs.push("states[] must be a non-empty array");
-    return errs;
-  }
-  if (!Array.isArray(spec.transitions)) {
-    errs.push("transitions[] must be an array");
-    return errs;
-  }
-  const ids = /* @__PURE__ */ new Set();
-  let initialCount = 0;
-  for (const [i, s2] of spec.states.entries()) {
-    if (!s2.id) {
-      errs.push(`states[${i}].id is required`);
-      continue;
-    }
-    if (ids.has(s2.id)) errs.push(`states[${i}].id "${s2.id}" is duplicated`);
-    ids.add(s2.id);
-    if (!s2.label) errs.push(`states[${i}].label is required`);
-    if (s2.initial) initialCount += 1;
-    if (s2.status && !["idle", "generating", "approval"].includes(s2.status)) {
-      errs.push(`states[${i}].status "${s2.status}" must be idle|generating|approval`);
-    }
-  }
-  if (initialCount === 0) errs.push("exactly one state must have initial:true (none found)");
-  if (initialCount > 1) errs.push(`exactly one state must have initial:true (${initialCount} found)`);
-  const sectionIds = new Set(Object.keys(spec.sections ?? {}));
-  for (const [i, t] of spec.transitions.entries()) {
-    const froms = t.from === "*" ? [] : Array.isArray(t.from) ? t.from : [t.from];
-    for (const f of froms) {
-      if (!ids.has(f)) errs.push(`transitions[${i}].from references unknown state "${f}"`);
-    }
-    if (t.from !== "*" && froms.length === 0) errs.push(`transitions[${i}].from is required`);
-    if (!t.to) errs.push(`transitions[${i}].to is required`);
-    else if (!ids.has(t.to)) errs.push(`transitions[${i}].to references unknown state "${t.to}"`);
-    if (t.when) errs.push(...validateCondition(t.when, sectionIds, `transitions[${i}].when`));
-  }
-  for (const [i, s2] of spec.states.entries()) {
-    const sec = s2.extract?.title?.section;
-    if (sec && !sectionIds.has(sec)) errs.push(`states[${i}].extract.title.section "${sec}" unknown`);
-    const bsec = s2.extract?.buttons?.section;
-    if (bsec && !sectionIds.has(bsec)) errs.push(`states[${i}].extract.buttons.section "${bsec}" unknown`);
-  }
-  return errs;
-}
-function validateCondition(c, sectionIds, path42) {
-  const errs = [];
-  const w = c;
-  if ("all" in w) {
-    w.all.forEach((x, i) => errs.push(...validateCondition(x, sectionIds, `${path42}.all[${i}]`)));
-    return errs;
-  }
-  if ("any" in w) {
-    w.any.forEach((x, i) => errs.push(...validateCondition(x, sectionIds, `${path42}.any[${i}]`)));
-    return errs;
-  }
-  if ("not" in w) {
-    errs.push(...validateCondition(w.not, sectionIds, `${path42}.not`));
-    return errs;
-  }
-  if ("matches" in w) {
-    if (w.section && !sectionIds.has(w.section)) errs.push(`${path42}.section "${w.section}" unknown`);
-    try {
-      new RegExp(w.matches, w.flags ?? "i");
-    } catch (e) {
-      errs.push(`${path42}.matches invalid regex: ${e.message}`);
-    }
-    return errs;
-  }
-  if ("cursor_above" in w && "changed" in w) return errs;
-  if ("elapsed_ms" in w) {
-    if (typeof w.elapsed_ms !== "number") errs.push(`${path42}.elapsed_ms must be a number`);
-    return errs;
-  }
-  if ("stable_ms" in w) {
-    if (typeof w.stable_ms !== "number") errs.push(`${path42}.stable_ms must be a number`);
-    return errs;
-  }
-  errs.push(`${path42} is not a recognized condition`);
-  return errs;
-}
-var init_fsm_loader = __esm({
-  "src/providers/spec/fsm-loader.ts"() {
-    "use strict";
-    init_fsm_types();
-  }
-});
-
 // src/providers/sdk/v1/sandbox/require-whitelist.ts
 var require_whitelist_exports = {};
 __export(require_whitelist_exports, {
@@ -32685,6 +32685,503 @@ ${formatManifestValidationIssues2(validation.issues)}`,
   }
 };
 
+// src/commands/low-family/session-host.ts
+function toHostedCliRuntimeDescriptor(record) {
+  if (!record || typeof record !== "object") return null;
+  const runtimeId = typeof record.sessionId === "string" ? record.sessionId : "";
+  const cliType = typeof record.providerType === "string" ? record.providerType : "";
+  const workspace = typeof record.workspace === "string" ? record.workspace : "";
+  if (!runtimeId || !cliType || !workspace) return null;
+  return {
+    runtimeId,
+    runtimeKey: typeof record.runtimeKey === "string" ? record.runtimeKey : void 0,
+    displayName: typeof record.displayName === "string" ? record.displayName : void 0,
+    workspaceLabel: typeof record.workspaceLabel === "string" ? record.workspaceLabel : void 0,
+    lifecycle: typeof record.lifecycle === "string" ? record.lifecycle : void 0,
+    recoveryState: typeof record.meta?.runtimeRecoveryState === "string" ? String(record.meta.runtimeRecoveryState) : null,
+    cliType,
+    workspace,
+    cliArgs: Array.isArray(record.meta?.cliArgs) ? record.meta.cliArgs : [],
+    providerSessionId: typeof record.meta?.providerSessionId === "string" ? String(record.meta.providerSessionId) : void 0
+  };
+}
+function getWriteConflictOwnerClientId(error) {
+  const message = typeof error === "string" ? error : error instanceof Error ? error.message : "";
+  const match = /^Write owned by\s+(.+)$/.exec(message.trim());
+  return match?.[1]?.trim() || void 0;
+}
+function summarizeSessionHostRecord(result) {
+  if (!result || typeof result !== "object") return {};
+  const record = result;
+  return {
+    runtimeKey: typeof record.runtimeKey === "string" ? record.runtimeKey : void 0,
+    lifecycle: typeof record.lifecycle === "string" ? record.lifecycle : void 0,
+    surfaceKind: getSessionHostSurfaceKind(record),
+    attachedClientCount: Array.isArray(record.attachedClients) ? record.attachedClients.length : void 0,
+    hasWriteOwner: !!record.writeOwner,
+    writeOwnerClientId: typeof record.writeOwner?.clientId === "string" ? record.writeOwner.clientId : void 0
+  };
+}
+function summarizeSessionHostRecords(result) {
+  const records = Array.isArray(result) ? result : [];
+  const groups = partitionSessionHostRecords(records);
+  return {
+    sessionCount: records.length,
+    liveRuntimeCount: groups.liveRuntimes.length,
+    recoverySnapshotCount: groups.recoverySnapshots.length,
+    inactiveRecordCount: groups.inactiveRecords.length
+  };
+}
+function summarizeSessionHostDiagnostics(result) {
+  const diagnostics = result && typeof result === "object" ? result : {};
+  const sessions = Array.isArray(diagnostics.sessions) ? diagnostics.sessions : [];
+  return {
+    runtimeCount: typeof diagnostics.runtimeCount === "number" ? diagnostics.runtimeCount : void 0,
+    ...summarizeSessionHostRecords(sessions)
+  };
+}
+function summarizeSessionHostPruneResult(result) {
+  const value = result && typeof result === "object" ? result : {};
+  return {
+    duplicateGroupCount: typeof value.duplicateGroupCount === "number" ? value.duplicateGroupCount : void 0,
+    prunedCount: Array.isArray(value.prunedSessionIds) ? value.prunedSessionIds.length : void 0,
+    keptCount: Array.isArray(value.keptSessionIds) ? value.keptSessionIds.length : void 0
+  };
+}
+async function traceSessionHostAction(action, args, run, summarizeResult2) {
+  const interactionId = typeof args?._interactionId === "string" ? args._interactionId : void 0;
+  const sessionId = typeof args?.sessionId === "string" ? args.sessionId : void 0;
+  const requestedPayload = { action };
+  if (sessionId) requestedPayload.sessionId = sessionId;
+  if (typeof args?.clientId === "string") requestedPayload.clientId = args.clientId;
+  if (typeof args?.signal === "string") requestedPayload.signal = args.signal;
+  if (typeof args?.providerType === "string") requestedPayload.providerType = args.providerType;
+  if (typeof args?.workspace === "string") requestedPayload.workspace = args.workspace;
+  if (typeof args?.dryRun === "boolean") requestedPayload.dryRun = args.dryRun;
+  recordDebugTrace({
+    interactionId,
+    category: "session_host",
+    stage: "action_requested",
+    level: "info",
+    sessionId,
+    payload: requestedPayload
+  });
+  try {
+    const result = await run();
+    recordDebugTrace({
+      interactionId,
+      category: "session_host",
+      stage: "action_result",
+      level: "info",
+      sessionId,
+      payload: {
+        ...requestedPayload,
+        success: true,
+        ...summarizeResult2 ? summarizeResult2(result) : {}
+      }
+    });
+    return result;
+  } catch (error) {
+    recordDebugTrace({
+      interactionId,
+      category: "session_host",
+      stage: "action_failed",
+      level: "error",
+      sessionId,
+      payload: {
+        ...requestedPayload,
+        error: error?.message || String(error),
+        failureKind: getWriteConflictOwnerClientId(error) ? "write_conflict" : "request_failed",
+        conflictOwnerClientId: getWriteConflictOwnerClientId(error)
+      }
+    });
+    throw error;
+  }
+}
+var sessionHostHandlers = {
+  session_host_get_diagnostics: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const diagnostics = await traceSessionHostAction("session_host_get_diagnostics", args, () => ctx.deps.sessionHostControl.getDiagnostics({
+      includeSessions: args?.includeSessions !== false,
+      limit: Number(args?.limit) || void 0
+    }), (result) => ({
+      includeSessions: args?.includeSessions !== false,
+      limit: Number(args?.limit) || void 0,
+      ...summarizeSessionHostDiagnostics(result)
+    }));
+    return { success: true, diagnostics };
+  },
+  session_host_list_sessions: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessions = await traceSessionHostAction("session_host_list_sessions", args, () => ctx.deps.sessionHostControl.listSessions(), (records) => summarizeSessionHostRecords(records));
+    return { success: true, sessions };
+  },
+  session_host_stop_session: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    const record = await traceSessionHostAction("session_host_stop_session", args, () => ctx.deps.sessionHostControl.stopSession(sessionId), (result) => summarizeSessionHostRecord(result));
+    return { success: true, record };
+  },
+  session_host_resume_session: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    const record = await traceSessionHostAction("session_host_resume_session", args, async () => {
+      const nextRecord = await ctx.deps.sessionHostControl.resumeSession(sessionId);
+      const hosted = toHostedCliRuntimeDescriptor(nextRecord);
+      if (hosted) {
+        await ctx.deps.cliManager.restoreHostedSessions([hosted]);
+      }
+      return nextRecord;
+    }, (result) => ({
+      ...summarizeSessionHostRecord(result),
+      restoredHostedSession: !!toHostedCliRuntimeDescriptor(result)
+    }));
+    return { success: true, record };
+  },
+  session_host_restart_session: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    const record = await traceSessionHostAction("session_host_restart_session", args, async () => {
+      const nextRecord = await ctx.deps.sessionHostControl.restartSession(sessionId);
+      const hosted = toHostedCliRuntimeDescriptor(nextRecord);
+      if (hosted) {
+        await ctx.deps.cliManager.restoreHostedSessions([hosted]);
+      }
+      return nextRecord;
+    }, (result) => ({
+      ...summarizeSessionHostRecord(result),
+      restoredHostedSession: !!toHostedCliRuntimeDescriptor(result)
+    }));
+    return { success: true, record };
+  },
+  session_host_send_signal: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    const signal = typeof args?.signal === "string" ? args.signal : "";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    if (!signal) return { success: false, error: "signal required" };
+    const record = await traceSessionHostAction("session_host_send_signal", args, () => ctx.deps.sessionHostControl.sendSignal(sessionId, signal), (result) => summarizeSessionHostRecord(result));
+    return { success: true, record };
+  },
+  session_host_force_detach_client: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    const clientId = typeof args?.clientId === "string" ? args.clientId : "";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    if (!clientId) return { success: false, error: "clientId required" };
+    const record = await traceSessionHostAction("session_host_force_detach_client", args, () => ctx.deps.sessionHostControl.forceDetachClient(sessionId, clientId), (result) => summarizeSessionHostRecord(result));
+    return { success: true, record };
+  },
+  session_host_prune_duplicate_sessions: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const result = await traceSessionHostAction("session_host_prune_duplicate_sessions", args, () => ctx.deps.sessionHostControl.pruneDuplicateSessions({
+      providerType: typeof args?.providerType === "string" ? args.providerType : void 0,
+      workspace: typeof args?.workspace === "string" ? args.workspace : void 0,
+      dryRun: args?.dryRun === true
+    }), (value) => summarizeSessionHostPruneResult(value));
+    return { success: true, result };
+  },
+  session_host_acquire_write: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    const clientId = typeof args?.clientId === "string" ? args.clientId : "";
+    const ownerType = args?.ownerType === "agent" ? "agent" : "user";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    if (!clientId) return { success: false, error: "clientId required" };
+    const record = await traceSessionHostAction("session_host_acquire_write", args, () => ctx.deps.sessionHostControl.acquireWrite({
+      sessionId,
+      clientId,
+      ownerType,
+      force: args?.force !== false
+    }), (result) => ({
+      ...summarizeSessionHostRecord(result),
+      ownerType
+    }));
+    return { success: true, record };
+  },
+  session_host_release_write: async (ctx, args) => {
+    if (!ctx.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+    const clientId = typeof args?.clientId === "string" ? args.clientId : "";
+    if (!sessionId) return { success: false, error: "sessionId required" };
+    if (!clientId) return { success: false, error: "clientId required" };
+    const record = await traceSessionHostAction("session_host_release_write", args, () => ctx.deps.sessionHostControl.releaseWrite({
+      sessionId,
+      clientId
+    }), (result) => summarizeSessionHostRecord(result));
+    return { success: true, record };
+  }
+};
+
+// src/commands/low-family/spec-providerdev.ts
+function resolveSpecPathInProviders(specPath, fsm, pathm, osm) {
+  let rootReal;
+  try {
+    rootReal = fsm.realpathSync(pathm.join(osm.homedir(), ".adhdev", "providers"));
+  } catch (e) {
+    return { ok: false, error: `providers root unavailable: ${e.message}` };
+  }
+  const resolved = pathm.resolve(specPath);
+  const base = pathm.basename(resolved);
+  if (!/^[\w.-]+\.json$/.test(base)) {
+    return { ok: false, error: "refused: spec file must be a *.json basename" };
+  }
+  let parentReal;
+  try {
+    parentReal = fsm.realpathSync(pathm.dirname(resolved));
+  } catch (e) {
+    return { ok: false, error: `spec directory not found: ${e.message}` };
+  }
+  if (parentReal !== rootReal && !parentReal.startsWith(rootReal + pathm.sep)) {
+    return { ok: false, error: "refused: spec path must be under the providers root" };
+  }
+  const safe = pathm.join(parentReal, base);
+  try {
+    const st = fsm.lstatSync(safe);
+    if (st.isSymbolicLink()) return { ok: false, error: "refused: spec path is a symlink" };
+  } catch {
+  }
+  return { ok: true, path: safe };
+}
+var specProviderDevHandlers = {
+  get_spec_debug: async (ctx, args) => {
+    const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
+    if (!sessionId) return { success: false, error: "targetSessionId required" };
+    const target = ctx.deps.sessionRegistry.get(sessionId);
+    if (!target) return { success: false, error: "Session not found", sessionId };
+    const adapterObj = ctx.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter;
+    const snapshot = adapterObj ? typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : typeof adapterObj.getDebugState === "function" ? adapterObj.getDebugState() : null : null;
+    return {
+      success: true,
+      sessionId,
+      providerType: target.providerType,
+      isSpecProvider: snapshot !== null,
+      snapshot
+    };
+  },
+  // ── Spec source read/write for the debug panel's live editor.
+  //    Lets the dashboard load a session's spec.json, edit it, and save it back —
+  //    the driver's fs.watch picks up the change and hot-reloads the FSM with no
+  //    restart. Writes are confined to files under ~/.adhdev/providers.
+  get_spec_source: async (ctx, args) => {
+    const fsm = await import("fs");
+    const pathm = await import("path");
+    const osm = await import("os");
+    const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
+    let specPath = typeof args?.specPath === "string" ? args.specPath : "";
+    if (!specPath && sessionId) {
+      const target = ctx.deps.sessionRegistry.get(sessionId);
+      const adapterObj = target ? ctx.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter : null;
+      const snap = adapterObj && typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : null;
+      specPath = snap?.specPath ?? "";
+    }
+    if (!specPath) return { success: false, error: "specPath or resolvable targetSessionId required" };
+    const safe = resolveSpecPathInProviders(specPath, fsm, pathm, osm);
+    if (!safe.ok) return { success: false, error: safe.error, specPath };
+    try {
+      const content = fsm.readFileSync(safe.path, "utf8");
+      return { success: true, specPath: safe.path, content };
+    } catch (e) {
+      return { success: false, error: `read failed: ${e.message}`, specPath };
+    }
+  },
+  write_spec_source: async (_ctx, args) => {
+    const fsm = await import("fs");
+    const pathm = await import("path");
+    const osm = await import("os");
+    const specPath = typeof args?.specPath === "string" ? args.specPath : "";
+    const content = typeof args?.content === "string" ? args.content : "";
+    if (!specPath) return { success: false, error: "specPath required" };
+    if (!content) return { success: false, error: "content required" };
+    const safe = resolveSpecPathInProviders(specPath, fsm, pathm, osm);
+    if (!safe.ok) return { success: false, error: safe.error };
+    let parsed;
+    try {
+      parsed = JSON.parse(content);
+    } catch (e) {
+      return { success: false, error: `invalid JSON: ${e.message}` };
+    }
+    if (parsed?.$schema === "adhdev:cli/spec@4") {
+      const { validateFsmSpec: validateFsmSpec2 } = await Promise.resolve().then(() => (init_fsm_loader(), fsm_loader_exports));
+      const errs = validateFsmSpec2(parsed);
+      if (errs.length) return { success: false, error: "spec invalid", validationErrors: errs };
+    }
+    try {
+      fsm.writeFileSync(safe.path, content, "utf8");
+      return { success: true, specPath: safe.path };
+    } catch (e) {
+      return { success: false, error: `write failed: ${e.message}` };
+    }
+  },
+  // ── Validate an in-progress spec (string or object) without writing. The form
+  //    builder calls this on every change so Save can stay disabled while there
+  //    are structural / reference / regex errors.
+  validate_spec: async (_ctx, args) => {
+    let parsed = args?.spec;
+    if (typeof args?.content === "string") {
+      try {
+        parsed = JSON.parse(args.content);
+      } catch (e) {
+        return { success: true, valid: false, errors: [`invalid JSON: ${e.message}`] };
+      }
+    }
+    if (!parsed || typeof parsed !== "object") {
+      return { success: true, valid: false, errors: ["spec must be an object or content string"] };
+    }
+    const schema = parsed.$schema;
+    if (schema === "adhdev:cli/spec@4") {
+      const { validateFsmSpec: validateFsmSpec2 } = await Promise.resolve().then(() => (init_fsm_loader(), fsm_loader_exports));
+      const errors = validateFsmSpec2(parsed);
+      return { success: true, valid: errors.length === 0, errors };
+    }
+    return { success: true, valid: false, errors: [`unsupported $schema "${schema}" \u2014 form builder is v4-only`] };
+  },
+  // ── Evaluate a single condition against a live session's current screen —
+  //    powers the editor's "does this match right now?" preview. Returns the
+  //    recursive match tree.
+  eval_condition_preview: async (ctx, args) => {
+    const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
+    if (!sessionId) return { success: false, error: "targetSessionId required" };
+    if (!args?.condition || typeof args.condition !== "object") return { success: false, error: "condition required" };
+    const target = ctx.deps.sessionRegistry.get(sessionId);
+    if (!target) return { success: false, error: "Session not found", sessionId };
+    const adapterObj = ctx.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter;
+    const snap = adapterObj && typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : null;
+    if (!snap?.screen) return { success: false, error: "no live screen for session" };
+    let sectionsDef;
+    try {
+      const fsm2 = await import("fs");
+      if (snap.specPath) {
+        const raw = JSON.parse(fsm2.readFileSync(snap.specPath, "utf8"));
+        sectionsDef = raw?.sections;
+      }
+    } catch {
+    }
+    const { evaluateConditionPreview: evaluateConditionPreview2 } = await Promise.resolve().then(() => (init_fsm_evaluator(), fsm_evaluator_exports));
+    try {
+      const result = evaluateConditionPreview2(
+        args.condition,
+        sectionsDef,
+        snap.screen,
+        snap.cursorPosition ?? void 0
+      );
+      return { success: true, result, sections: snap.sections ?? null };
+    } catch (e) {
+      return { success: false, error: `eval failed: ${e.message}` };
+    }
+  },
+  // ── Resolve a sections map against a live session's screen — the section
+  //    editor's "test" button. Returns, for each section id, the line range + the
+  //    text it captures. Accepts an in-progress sections map so it previews
+  //    unsaved edits.
+  resolve_section_preview: async (ctx, args) => {
+    const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
+    if (!sessionId) return { success: false, error: "targetSessionId required" };
+    if (!args?.sections || typeof args.sections !== "object") return { success: false, error: "sections map required" };
+    const target = ctx.deps.sessionRegistry.get(sessionId);
+    if (!target) return { success: false, error: "Session not found", sessionId };
+    const adapterObj = ctx.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter;
+    const snap = adapterObj && typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : null;
+    if (!snap?.screen) return { success: false, error: "no live screen for session" };
+    const { resolveSections: resolveSections2 } = await Promise.resolve().then(() => (init_evaluator(), evaluator_exports));
+    try {
+      const lines = String(snap.screen).split("\n").map((l) => l.endsWith("\r") ? l.slice(0, -1) : l);
+      const resolved = resolveSections2(args.sections, lines);
+      return {
+        success: true,
+        screenLineCount: lines.length,
+        sections: resolved.map((s2) => ({ id: s2.id, fromLine: s2.fromLine, toLine: s2.toLine, text: s2.text }))
+      };
+    } catch (e) {
+      return { success: false, error: `resolve failed: ${e.message}` };
+    }
+  }
+};
+
+// src/commands/low-family/refine-config.ts
+init_change_impact_config();
+var refineConfigHandlers = {
+  get_mesh_refine_config_schema: async (_ctx, _args) => {
+    return {
+      success: true,
+      schema: MESH_REFINE_CONFIG_SCHEMA,
+      locations: MESH_REFINE_CONFIG_LOCATIONS,
+      worktreeBootstrap: {
+        schema: MESH_WORKTREE_BOOTSTRAP_CONFIG_SCHEMA,
+        locations: MESH_WORKTREE_BOOTSTRAP_CONFIG_LOCATIONS,
+        sourceOfTruth: "repo worktree bootstrap config",
+        runBehavior: "When present and enabled, clone_mesh_node runs commands after submodule initialization and records status on the worktree node."
+      },
+      sourceOfTruth: "repo mesh/refine config",
+      heuristicRole: "suggestions_only_not_execution_path"
+    };
+  },
+  validate_mesh_refine_config: async (_ctx, args) => {
+    const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
+    const mesh = args?.inlineMesh || {};
+    const loaded = args?.config !== void 0 ? { config: args.config, source: "inline", sourceType: "mesh_policy" } : loadMeshRefineConfig(mesh, workspace);
+    const validation = loaded.config ? validateMeshRefineConfig(loaded.config, loaded.source) : { valid: false, errors: [loaded.error || "repo mesh/refine config unavailable"], commands: [], rejectedCommands: [] };
+    return { success: validation.valid, ...loaded, ...validation };
+  },
+  suggest_mesh_refine_config: async (_ctx, args) => {
+    const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
+    const mesh = args?.inlineMesh || {};
+    return {
+      success: true,
+      ...suggestMeshRefineConfig(mesh, workspace),
+      note: "Suggestions are heuristic scaffold only; Refinery will not execute them until saved into repo mesh/refine config."
+    };
+  },
+  get_mesh_change_impact_config_schema: async (_ctx, _args) => {
+    return {
+      success: true,
+      schema: CHANGE_IMPACT_CONFIG_SCHEMA,
+      locations: CHANGE_IMPACT_CONFIG_LOCATIONS,
+      sourceOfTruth: "repo change-impact config",
+      heuristicRole: "suggestions_only_not_execution_path",
+      note: "Declarative config only \u2014 JSON/YAML are parsed but never executed. Defines which package/file changes require a daemon rebuild/restart vs. a web-only redeploy vs. nothing."
+    };
+  },
+  validate_mesh_change_impact_config: async (_ctx, args) => {
+    const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
+    if (args?.config !== void 0) {
+      const validation = validateChangeImpactConfig(args.config, "inline");
+      return { success: validation.valid, source: "inline", sourceType: "mesh_policy", ...validation };
+    }
+    const loaded = loadChangeImpactConfig(workspace);
+    if (loaded.sourceType === "repo_file") {
+      const validation = validateChangeImpactConfig(loaded.config, loaded.source);
+      return { success: validation.valid, ...loaded, ...validation };
+    }
+    return {
+      success: false,
+      ...loaded,
+      valid: false,
+      errors: [loaded.error || "repo change-impact config unavailable"]
+    };
+  },
+  suggest_mesh_change_impact_config: async (_ctx, args) => {
+    const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
+    return {
+      success: true,
+      ...suggestChangeImpactConfig(workspace),
+      note: "Suggestions are heuristic scaffold only; the draft must be reviewed and saved into repo change-impact config before it takes effect. Nothing is executed."
+    };
+  }
+};
+
+// src/commands/low-family/index.ts
+var lowFamilyRegistry = new Map(
+  Object.entries({
+    ...sessionHostHandlers,
+    ...specProviderDevHandlers,
+    ...refineConfigHandlers
+  })
+);
+
 // src/commands/cli-manager.ts
 init_provider_cli_adapter();
 init_cli_detector();
@@ -36220,7 +36717,13 @@ var CliProviderInstance = class _CliProviderInstance {
     this.settings = {
       ...this.settings,
       meshNodeFor: assignment.meshId,
-      ...assignment.nodeId ? { meshNodeId: assignment.nodeId } : {},
+      // WTCLAIM (A): track the bound node id under BOTH the active marker
+      // (meshNodeId, cleared on detach) and a sticky marker (meshLastNodeId,
+      // preserved across detach). The sticky marker lets a detached but still
+      // coordinator-owned session be re-picked ONLY for the SAME node it served
+      // — never auto-adopted for a sibling node (e.g. a cloned worktree) that
+      // shares this daemon. See isMeshOwnedDelegateSession's post-detach gate.
+      ...assignment.nodeId ? { meshNodeId: assignment.nodeId, meshLastNodeId: assignment.nodeId } : {},
       ...assignment.taskId ? { meshActiveTaskId: assignment.taskId } : {},
       ...assignment.coordinatorDaemonId ? { meshCoordinatorDaemonId: assignment.coordinatorDaemonId } : {},
       // Session-level routing anchor: the originating coordinator session, so this
@@ -36239,9 +36742,9 @@ var CliProviderInstance = class _CliProviderInstance {
     if (!this.settings.meshNodeFor && !this.settings.meshActiveTaskId && !this.settings.meshNodeId) return;
     const { meshNodeFor, meshNodeId, meshActiveTaskId, ...rest } = this.settings;
     void meshNodeFor;
-    void meshNodeId;
     void meshActiveTaskId;
-    this.settings = rest;
+    const lastNodeId = typeof meshNodeId === "string" && meshNodeId.trim() ? meshNodeId.trim() : typeof rest.meshLastNodeId === "string" && rest.meshLastNodeId.trim() ? rest.meshLastNodeId.trim() : void 0;
+    this.settings = lastNodeId ? { ...rest, meshLastNodeId: lastNodeId } : rest;
     this.adapter.updateRuntimeSettings?.(this.settings);
   }
   /**
@@ -38917,6 +39420,10 @@ function hasCompletedStartingLaunch(adapter) {
   if (hasNonEmptyModalButtons2(adapterStatus?.activeModal ?? adapterStatus?.modal ?? parsedStatus?.activeModal ?? parsedStatus?.modal)) return false;
   return hasFinalAssistantMessage(parsedStatus?.messages);
 }
+function normalizeDirForCompare(dir) {
+  if (typeof dir !== "string") return "";
+  return dir.trim().replace(/[\\/]+/g, "/").replace(/\/+$/, "").toLowerCase();
+}
 function shouldSuppressStaleParsedBusyStatus(adapterStatus, parsedStatus, adapter) {
   const parsedRawStatus = normalizeAgentStatus(parsedStatus?.status);
   if (!BUSY_AGENT_STATUSES.has(parsedRawStatus)) return false;
@@ -39665,6 +40172,33 @@ Run 'adhdev doctor' for detailed diagnostics.`
     const adapter = this.adapters.get(ik);
     return adapter ? { adapter, key: ik } : null;
   }
+  /**
+   * WTCLAIM (B): resolve the adapter for a mesh dispatch that named a node
+   * (meshContext.nodeId) but carried no explicit session. Matches by the
+   * instance's bound mesh node id (settings.meshNodeId, falling back to the
+   * sticky meshLastNodeId) first, then by the node workspace (workingDir).
+   *
+   * Unlike findAdapter's step-2 fuzzy fallback, this NEVER degrades to a
+   * provider-only first-match: on a daemon hosting BOTH a base node and a
+   * cloned worktree node (same daemonId), that fuzzy match could land a
+   * worktree-targeted task on the base session. Returns null when no session
+   * is bound to this node so the caller fails closed.
+   */
+  findMeshNodeAdapter(agentType, nodeId, dir) {
+    const instanceManager = this.deps.getInstanceManager();
+    const targetDir = normalizeDirForCompare(dir);
+    let workspaceMatch = null;
+    for (const [k, a] of this.adapters) {
+      if (a.cliType !== agentType) continue;
+      const settings = instanceManager?.getInstance(k)?.getState?.()?.settings;
+      const boundNodeId = typeof settings?.meshNodeId === "string" && settings.meshNodeId.trim() ? settings.meshNodeId.trim() : typeof settings?.meshLastNodeId === "string" ? settings.meshLastNodeId.trim() : "";
+      if (boundNodeId && boundNodeId === nodeId) return { adapter: a, key: k };
+      if (!workspaceMatch && targetDir && normalizeDirForCompare(a.workingDir) === targetDir) {
+        workspaceMatch = { adapter: a, key: k };
+      }
+    }
+    return workspaceMatch;
+  }
   // ─── CLI command handling ────────────────────────────
   async handleCliCommand(cmd, args) {
     switch (cmd) {
@@ -39850,10 +40384,22 @@ Run 'adhdev doctor' for detailed diagnostics.`
         const agentType = args?.agentType || args?.cliType;
         const action = args?.action;
         if (!agentType || !action) throw new Error("agentType and action required");
-        const found = this.findAdapter(agentType, {
-          dir: args?.dir,
-          instanceKey: args?.targetSessionId
-        });
+        const meshScopeNodeId = (() => {
+          const mc = args?.meshContext;
+          return mc && typeof mc === "object" && typeof mc.nodeId === "string" ? mc.nodeId.trim() : "";
+        })();
+        let found;
+        if (meshScopeNodeId && !args?.targetSessionId) {
+          found = this.findMeshNodeAdapter(agentType, meshScopeNodeId, args?.dir);
+          if (!found) {
+            throw new Error(`No mesh worker session bound to node '${meshScopeNodeId}' for agent '${agentType}' on this daemon; refusing provider-only fuzzy match to avoid cross-node dispatch`);
+          }
+        } else {
+          found = this.findAdapter(agentType, {
+            dir: args?.dir,
+            instanceKey: args?.targetSessionId
+          });
+        }
         if (!found) throw new Error(`CLI agent not running: ${agentType}`);
         const { adapter, key } = found;
         if (action === "send_chat") {
@@ -43747,7 +44293,6 @@ init_workspaces();
 init_recent_activity();
 init_cli_detector();
 init_git_status();
-init_change_impact_config();
 init_dist();
 init_logger();
 
@@ -45090,7 +45635,7 @@ function buildMeshNodeMachineIdentity(node, opts) {
   const machineName = readMeshNodeDisplayMachineName(node);
   const coordinatorHostname = readStringValue(opts.coordinatorHostname);
   const machineIdMatches = Boolean(opts.localMachineId && machineId && opts.localMachineId === machineId);
-  const daemonIdMatches = Boolean(opts.localDaemonId && daemonId && opts.localDaemonId === daemonId);
+  const daemonIdMatches = Boolean(opts.localDaemonId && daemonId && daemonIdsEquivalent(opts.localDaemonId, daemonId));
   const hostnameMatches = Boolean(
     normalizeMeshHostname(hostname3) && normalizeMeshHostname(coordinatorHostname) && normalizeMeshHostname(hostname3) === normalizeMeshHostname(coordinatorHostname)
   );
@@ -45805,10 +46350,10 @@ async function hydrateInlineMeshDirectTruth(args) {
     const isSelfNode = Boolean(
       nodeId && selectedCoordinatorNodeId && nodeId === selectedCoordinatorNodeId
     ) || Boolean(
-      daemonId && (daemonId === args.localMachineId || daemonId === args.statusInstanceId)
+      daemonId && (daemonIdsEquivalent(daemonId, args.localMachineId) || daemonIdsEquivalent(daemonId, args.statusInstanceId))
     ) || Boolean(args.meshSource !== "local_config" && nodeIndex === 0);
     const isSelfDaemonNode = Boolean(
-      daemonId && (daemonId === args.localMachineId || daemonId === args.statusInstanceId)
+      daemonId && (daemonIdsEquivalent(daemonId, args.localMachineId) || daemonIdsEquivalent(daemonId, args.statusInstanceId))
     );
     if ((isSelfNode || isSelfDaemonNode) && isDeadLocalWorktreeNode(node)) {
       deadNodeIds.push(nodeId);
@@ -47147,97 +47692,6 @@ function normalizeCommandArgsWithInteractionId(args) {
   }
   return base;
 }
-function resolveSpecPathInProviders(specPath, fsm, pathm, osm) {
-  let rootReal;
-  try {
-    rootReal = fsm.realpathSync(pathm.join(osm.homedir(), ".adhdev", "providers"));
-  } catch (e) {
-    return { ok: false, error: `providers root unavailable: ${e.message}` };
-  }
-  const resolved = pathm.resolve(specPath);
-  const base = pathm.basename(resolved);
-  if (!/^[\w.-]+\.json$/.test(base)) {
-    return { ok: false, error: "refused: spec file must be a *.json basename" };
-  }
-  let parentReal;
-  try {
-    parentReal = fsm.realpathSync(pathm.dirname(resolved));
-  } catch (e) {
-    return { ok: false, error: `spec directory not found: ${e.message}` };
-  }
-  if (parentReal !== rootReal && !parentReal.startsWith(rootReal + pathm.sep)) {
-    return { ok: false, error: "refused: spec path must be under the providers root" };
-  }
-  const safe = pathm.join(parentReal, base);
-  try {
-    const st = fsm.lstatSync(safe);
-    if (st.isSymbolicLink()) return { ok: false, error: "refused: spec path is a symlink" };
-  } catch {
-  }
-  return { ok: true, path: safe };
-}
-function toHostedCliRuntimeDescriptor(record) {
-  if (!record || typeof record !== "object") return null;
-  const runtimeId = typeof record.sessionId === "string" ? record.sessionId : "";
-  const cliType = typeof record.providerType === "string" ? record.providerType : "";
-  const workspace = typeof record.workspace === "string" ? record.workspace : "";
-  if (!runtimeId || !cliType || !workspace) return null;
-  return {
-    runtimeId,
-    runtimeKey: typeof record.runtimeKey === "string" ? record.runtimeKey : void 0,
-    displayName: typeof record.displayName === "string" ? record.displayName : void 0,
-    workspaceLabel: typeof record.workspaceLabel === "string" ? record.workspaceLabel : void 0,
-    lifecycle: typeof record.lifecycle === "string" ? record.lifecycle : void 0,
-    recoveryState: typeof record.meta?.runtimeRecoveryState === "string" ? String(record.meta.runtimeRecoveryState) : null,
-    cliType,
-    workspace,
-    cliArgs: Array.isArray(record.meta?.cliArgs) ? record.meta.cliArgs : [],
-    providerSessionId: typeof record.meta?.providerSessionId === "string" ? String(record.meta.providerSessionId) : void 0
-  };
-}
-function getWriteConflictOwnerClientId(error) {
-  const message = typeof error === "string" ? error : error instanceof Error ? error.message : "";
-  const match = /^Write owned by\s+(.+)$/.exec(message.trim());
-  return match?.[1]?.trim() || void 0;
-}
-function summarizeSessionHostRecord(result) {
-  if (!result || typeof result !== "object") return {};
-  const record = result;
-  return {
-    runtimeKey: typeof record.runtimeKey === "string" ? record.runtimeKey : void 0,
-    lifecycle: typeof record.lifecycle === "string" ? record.lifecycle : void 0,
-    surfaceKind: getSessionHostSurfaceKind(record),
-    attachedClientCount: Array.isArray(record.attachedClients) ? record.attachedClients.length : void 0,
-    hasWriteOwner: !!record.writeOwner,
-    writeOwnerClientId: typeof record.writeOwner?.clientId === "string" ? record.writeOwner.clientId : void 0
-  };
-}
-function summarizeSessionHostRecords(result) {
-  const records = Array.isArray(result) ? result : [];
-  const groups = partitionSessionHostRecords(records);
-  return {
-    sessionCount: records.length,
-    liveRuntimeCount: groups.liveRuntimes.length,
-    recoverySnapshotCount: groups.recoverySnapshots.length,
-    inactiveRecordCount: groups.inactiveRecords.length
-  };
-}
-function summarizeSessionHostDiagnostics(result) {
-  const diagnostics = result && typeof result === "object" ? result : {};
-  const sessions = Array.isArray(diagnostics.sessions) ? diagnostics.sessions : [];
-  return {
-    runtimeCount: typeof diagnostics.runtimeCount === "number" ? diagnostics.runtimeCount : void 0,
-    ...summarizeSessionHostRecords(sessions)
-  };
-}
-function summarizeSessionHostPruneResult(result) {
-  const value = result && typeof result === "object" ? result : {};
-  return {
-    duplicateGroupCount: typeof value.duplicateGroupCount === "number" ? value.duplicateGroupCount : void 0,
-    prunedCount: Array.isArray(value.prunedSessionIds) ? value.prunedSessionIds.length : void 0,
-    keptCount: Array.isArray(value.keptSessionIds) ? value.keptSessionIds.length : void 0
-  };
-}
 function normalizeStandaloneHostCommandUrl(hostAddress) {
   const raw = hostAddress.trim();
   if (!raw) throw new Error("hostAddress required");
@@ -48087,56 +48541,6 @@ var DaemonCommandRouter = class {
       ...errors.length ? { errors } : {}
     };
   }
-  async traceSessionHostAction(action, args, run, summarizeResult2) {
-    const interactionId = typeof args?._interactionId === "string" ? args._interactionId : void 0;
-    const sessionId = typeof args?.sessionId === "string" ? args.sessionId : void 0;
-    const requestedPayload = { action };
-    if (sessionId) requestedPayload.sessionId = sessionId;
-    if (typeof args?.clientId === "string") requestedPayload.clientId = args.clientId;
-    if (typeof args?.signal === "string") requestedPayload.signal = args.signal;
-    if (typeof args?.providerType === "string") requestedPayload.providerType = args.providerType;
-    if (typeof args?.workspace === "string") requestedPayload.workspace = args.workspace;
-    if (typeof args?.dryRun === "boolean") requestedPayload.dryRun = args.dryRun;
-    recordDebugTrace({
-      interactionId,
-      category: "session_host",
-      stage: "action_requested",
-      level: "info",
-      sessionId,
-      payload: requestedPayload
-    });
-    try {
-      const result = await run();
-      recordDebugTrace({
-        interactionId,
-        category: "session_host",
-        stage: "action_result",
-        level: "info",
-        sessionId,
-        payload: {
-          ...requestedPayload,
-          success: true,
-          ...summarizeResult2 ? summarizeResult2(result) : {}
-        }
-      });
-      return result;
-    } catch (error) {
-      recordDebugTrace({
-        interactionId,
-        category: "session_host",
-        stage: "action_failed",
-        level: "error",
-        sessionId,
-        payload: {
-          ...requestedPayload,
-          error: error?.message || String(error),
-          failureKind: getWriteConflictOwnerClientId(error) ? "write_conflict" : "request_failed",
-          conflictOwnerClientId: getWriteConflictOwnerClientId(error)
-        }
-      });
-      throw error;
-    }
-  }
   /**
    * Unified command routing.
    * Returns result for all commands:
@@ -49511,6 +49915,10 @@ ${hintLines.join("\n")}` : "",
         }
       }
     }
+    const lowFamilyHandler = lowFamilyRegistry.get(cmd);
+    if (lowFamilyHandler) {
+      return await lowFamilyHandler({ deps: this.deps }, args);
+    }
     switch (cmd) {
       // ─── CLI / ACP commands ───
       case "mesh_forward_event": {
@@ -49638,121 +50046,6 @@ ${hintLines.join("\n")}` : "",
         const trace = getRecentDebugTrace({ interactionId, category, limit: count }).filter((entry) => !sinceTs || entry.ts > sinceTs);
         return { success: true, trace, count: trace.length };
       }
-      case "session_host_get_diagnostics": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const diagnostics = await this.traceSessionHostAction("session_host_get_diagnostics", args, () => this.deps.sessionHostControl.getDiagnostics({
-          includeSessions: args?.includeSessions !== false,
-          limit: Number(args?.limit) || void 0
-        }), (result) => ({
-          includeSessions: args?.includeSessions !== false,
-          limit: Number(args?.limit) || void 0,
-          ...summarizeSessionHostDiagnostics(result)
-        }));
-        return { success: true, diagnostics };
-      }
-      case "session_host_list_sessions": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessions = await this.traceSessionHostAction("session_host_list_sessions", args, () => this.deps.sessionHostControl.listSessions(), (records) => summarizeSessionHostRecords(records));
-        return { success: true, sessions };
-      }
-      case "session_host_stop_session": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        const record = await this.traceSessionHostAction("session_host_stop_session", args, () => this.deps.sessionHostControl.stopSession(sessionId), (result) => summarizeSessionHostRecord(result));
-        return { success: true, record };
-      }
-      case "session_host_resume_session": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        const record = await this.traceSessionHostAction("session_host_resume_session", args, async () => {
-          const nextRecord = await this.deps.sessionHostControl.resumeSession(sessionId);
-          const hosted = toHostedCliRuntimeDescriptor(nextRecord);
-          if (hosted) {
-            await this.deps.cliManager.restoreHostedSessions([hosted]);
-          }
-          return nextRecord;
-        }, (result) => ({
-          ...summarizeSessionHostRecord(result),
-          restoredHostedSession: !!toHostedCliRuntimeDescriptor(result)
-        }));
-        return { success: true, record };
-      }
-      case "session_host_restart_session": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        const record = await this.traceSessionHostAction("session_host_restart_session", args, async () => {
-          const nextRecord = await this.deps.sessionHostControl.restartSession(sessionId);
-          const hosted = toHostedCliRuntimeDescriptor(nextRecord);
-          if (hosted) {
-            await this.deps.cliManager.restoreHostedSessions([hosted]);
-          }
-          return nextRecord;
-        }, (result) => ({
-          ...summarizeSessionHostRecord(result),
-          restoredHostedSession: !!toHostedCliRuntimeDescriptor(result)
-        }));
-        return { success: true, record };
-      }
-      case "session_host_send_signal": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        const signal = typeof args?.signal === "string" ? args.signal : "";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        if (!signal) return { success: false, error: "signal required" };
-        const record = await this.traceSessionHostAction("session_host_send_signal", args, () => this.deps.sessionHostControl.sendSignal(sessionId, signal), (result) => summarizeSessionHostRecord(result));
-        return { success: true, record };
-      }
-      case "session_host_force_detach_client": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        const clientId = typeof args?.clientId === "string" ? args.clientId : "";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        if (!clientId) return { success: false, error: "clientId required" };
-        const record = await this.traceSessionHostAction("session_host_force_detach_client", args, () => this.deps.sessionHostControl.forceDetachClient(sessionId, clientId), (result) => summarizeSessionHostRecord(result));
-        return { success: true, record };
-      }
-      case "session_host_prune_duplicate_sessions": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const result = await this.traceSessionHostAction("session_host_prune_duplicate_sessions", args, () => this.deps.sessionHostControl.pruneDuplicateSessions({
-          providerType: typeof args?.providerType === "string" ? args.providerType : void 0,
-          workspace: typeof args?.workspace === "string" ? args.workspace : void 0,
-          dryRun: args?.dryRun === true
-        }), (value) => summarizeSessionHostPruneResult(value));
-        return { success: true, result };
-      }
-      case "session_host_acquire_write": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        const clientId = typeof args?.clientId === "string" ? args.clientId : "";
-        const ownerType = args?.ownerType === "agent" ? "agent" : "user";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        if (!clientId) return { success: false, error: "clientId required" };
-        const record = await this.traceSessionHostAction("session_host_acquire_write", args, () => this.deps.sessionHostControl.acquireWrite({
-          sessionId,
-          clientId,
-          ownerType,
-          force: args?.force !== false
-        }), (result) => ({
-          ...summarizeSessionHostRecord(result),
-          ownerType
-        }));
-        return { success: true, record };
-      }
-      case "session_host_release_write": {
-        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
-        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
-        const clientId = typeof args?.clientId === "string" ? args.clientId : "";
-        if (!sessionId) return { success: false, error: "sessionId required" };
-        if (!clientId) return { success: false, error: "clientId required" };
-        const record = await this.traceSessionHostAction("session_host_release_write", args, () => this.deps.sessionHostControl.releaseWrite({
-          sessionId,
-          clientId
-        }), (result) => summarizeSessionHostRecord(result));
-        return { success: true, record };
-      }
       case "list_saved_sessions": {
         const providerType = typeof args?.providerType === "string" ? args.providerType.trim() : typeof args?.agentType === "string" ? args.agentType.trim() : "";
         const kind = args?.kind === "acp" ? "acp" : "cli";
@@ -50008,166 +50301,6 @@ ${hintLines.join("\n")}` : "",
           } : null
         };
       }
-      case "get_spec_debug": {
-        const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
-        if (!sessionId) return { success: false, error: "targetSessionId required" };
-        const target = this.deps.sessionRegistry.get(sessionId);
-        if (!target) return { success: false, error: "Session not found", sessionId };
-        const adapterObj = this.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter;
-        const snapshot = adapterObj ? typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : typeof adapterObj.getDebugState === "function" ? adapterObj.getDebugState() : null : null;
-        return {
-          success: true,
-          sessionId,
-          providerType: target.providerType,
-          isSpecProvider: snapshot !== null,
-          snapshot
-        };
-      }
-      // ── Spec source read/write for the debug panel's live editor.
-      //    Lets the dashboard load a session's spec.json, edit it, and
-      //    save it back — the driver's fs.watch picks up the change and
-      //    hot-reloads the FSM with no restart. Writes are confined to
-      //    files under ~/.adhdev/providers to avoid arbitrary fs access.
-      case "get_spec_source": {
-        const fsm = await import("fs");
-        const pathm = await import("path");
-        const osm = await import("os");
-        const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
-        let specPath = typeof args?.specPath === "string" ? args.specPath : "";
-        if (!specPath && sessionId) {
-          const target = this.deps.sessionRegistry.get(sessionId);
-          const adapterObj = target ? this.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter : null;
-          const snap = adapterObj && typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : null;
-          specPath = snap?.specPath ?? "";
-        }
-        if (!specPath) return { success: false, error: "specPath or resolvable targetSessionId required" };
-        const safe = resolveSpecPathInProviders(specPath, fsm, pathm, osm);
-        if (!safe.ok) return { success: false, error: safe.error, specPath };
-        try {
-          const content = fsm.readFileSync(safe.path, "utf8");
-          return { success: true, specPath: safe.path, content };
-        } catch (e) {
-          return { success: false, error: `read failed: ${e.message}`, specPath };
-        }
-      }
-      case "write_spec_source": {
-        const fsm = await import("fs");
-        const pathm = await import("path");
-        const osm = await import("os");
-        const specPath = typeof args?.specPath === "string" ? args.specPath : "";
-        const content = typeof args?.content === "string" ? args.content : "";
-        if (!specPath) return { success: false, error: "specPath required" };
-        if (!content) return { success: false, error: "content required" };
-        const safe = resolveSpecPathInProviders(specPath, fsm, pathm, osm);
-        if (!safe.ok) return { success: false, error: safe.error };
-        let parsed;
-        try {
-          parsed = JSON.parse(content);
-        } catch (e) {
-          return { success: false, error: `invalid JSON: ${e.message}` };
-        }
-        if (parsed?.$schema === "adhdev:cli/spec@4") {
-          const { validateFsmSpec: validateFsmSpec2 } = await Promise.resolve().then(() => (init_fsm_loader(), fsm_loader_exports));
-          const errs = validateFsmSpec2(parsed);
-          if (errs.length) return { success: false, error: "spec invalid", validationErrors: errs };
-        }
-        try {
-          fsm.writeFileSync(safe.path, content, "utf8");
-          return { success: true, specPath: safe.path };
-        } catch (e) {
-          return { success: false, error: `write failed: ${e.message}` };
-        }
-      }
-      // ── Validate an in-progress spec (string or object) without writing.
-      //    The form builder calls this on every change so Save can stay
-      //    disabled while there are structural / reference / regex errors.
-      case "validate_spec": {
-        let parsed = args?.spec;
-        if (typeof args?.content === "string") {
-          try {
-            parsed = JSON.parse(args.content);
-          } catch (e) {
-            return { success: true, valid: false, errors: [`invalid JSON: ${e.message}`] };
-          }
-        }
-        if (!parsed || typeof parsed !== "object") {
-          return { success: true, valid: false, errors: ["spec must be an object or content string"] };
-        }
-        const schema = parsed.$schema;
-        if (schema === "adhdev:cli/spec@4") {
-          const { validateFsmSpec: validateFsmSpec2 } = await Promise.resolve().then(() => (init_fsm_loader(), fsm_loader_exports));
-          const errors = validateFsmSpec2(parsed);
-          return { success: true, valid: errors.length === 0, errors };
-        }
-        return { success: true, valid: false, errors: [`unsupported $schema "${schema}" \u2014 form builder is v4-only`] };
-      }
-      // ── Evaluate a single condition against a live session's current
-      //    screen — powers the editor's "does this match right now?"
-      //    preview. Returns the recursive match tree.
-      case "eval_condition_preview": {
-        const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
-        if (!sessionId) return { success: false, error: "targetSessionId required" };
-        if (!args?.condition || typeof args.condition !== "object") return { success: false, error: "condition required" };
-        const target = this.deps.sessionRegistry.get(sessionId);
-        if (!target) return { success: false, error: "Session not found", sessionId };
-        const adapterObj = this.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter;
-        const snap = adapterObj && typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : null;
-        if (!snap?.screen) return { success: false, error: "no live screen for session" };
-        let sectionsDef;
-        try {
-          const fsm2 = await import("fs");
-          if (snap.specPath) {
-            const raw = JSON.parse(fsm2.readFileSync(snap.specPath, "utf8"));
-            sectionsDef = raw?.sections;
-          }
-        } catch {
-        }
-        const { evaluateConditionPreview: evaluateConditionPreview2 } = await Promise.resolve().then(() => (init_fsm_evaluator(), fsm_evaluator_exports));
-        try {
-          const result = evaluateConditionPreview2(
-            args.condition,
-            sectionsDef,
-            snap.screen,
-            snap.cursorPosition ?? void 0
-          );
-          return { success: true, result, sections: snap.sections ?? null };
-        } catch (e) {
-          return { success: false, error: `eval failed: ${e.message}` };
-        }
-      }
-      // ── Resolve a sections map against a live session's screen — the
-      //    section editor's "test" button. Returns, for each section id,
-      //    the line range + the text it captures, so the author can SEE
-      //    whether a from_top/until/anchor definition carves the screen
-      //    the way they intend. Accepts an in-progress sections map so it
-      //    previews unsaved edits.
-      case "resolve_section_preview": {
-        const sessionId = typeof args?.targetSessionId === "string" ? args.targetSessionId.trim() : typeof args?.sessionId === "string" ? args.sessionId.trim() : "";
-        if (!sessionId) return { success: false, error: "targetSessionId required" };
-        if (!args?.sections || typeof args.sections !== "object") return { success: false, error: "sections map required" };
-        const target = this.deps.sessionRegistry.get(sessionId);
-        if (!target) return { success: false, error: "Session not found", sessionId };
-        const adapterObj = this.deps.cliManager.findAdapter(target.providerType, { instanceKey: sessionId })?.adapter;
-        const snap = adapterObj && typeof adapterObj.getDebugSnapshot === "function" ? adapterObj.getDebugSnapshot() : null;
-        if (!snap?.screen) return { success: false, error: "no live screen for session" };
-        const { resolveSections: resolveSections2 } = await Promise.resolve().then(() => (init_evaluator(), evaluator_exports));
-        try {
-          const lines = String(snap.screen).split("\n").map((l) => l.endsWith("\r") ? l.slice(0, -1) : l);
-          const resolved = resolveSections2(args.sections, lines);
-          return {
-            success: true,
-            screenLineCount: lines.length,
-            sections: resolved.map((s2) => ({ id: s2.id, fromLine: s2.fromLine, toLine: s2.toLine, text: s2.text }))
-          };
-        } catch (e) {
-          return { success: false, error: `resolve failed: ${e.message}` };
-        }
-      }
-      // ── User-level coordinator-prompt files (~/.adhdev/coordinator-prompts/).
-      //    These live on this daemon's filesystem and never sync to the
-      //    cloud / other daemons — they're per-machine config. The
-      //    Settings page in the dashboard reads/writes via these two
-      //    commands instead of going through fs from the browser.
       case "list_coordinator_prompts": {
         const fs32 = await import("fs");
         const path42 = await import("path");
@@ -50888,73 +51021,6 @@ ${hintLines.join("\n")}` : "",
           return { success: false, error: e.message };
         }
       }
-      case "get_mesh_refine_config_schema": {
-        return {
-          success: true,
-          schema: MESH_REFINE_CONFIG_SCHEMA,
-          locations: MESH_REFINE_CONFIG_LOCATIONS,
-          worktreeBootstrap: {
-            schema: MESH_WORKTREE_BOOTSTRAP_CONFIG_SCHEMA,
-            locations: MESH_WORKTREE_BOOTSTRAP_CONFIG_LOCATIONS,
-            sourceOfTruth: "repo worktree bootstrap config",
-            runBehavior: "When present and enabled, clone_mesh_node runs commands after submodule initialization and records status on the worktree node."
-          },
-          sourceOfTruth: "repo mesh/refine config",
-          heuristicRole: "suggestions_only_not_execution_path"
-        };
-      }
-      case "validate_mesh_refine_config": {
-        const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
-        const mesh = args?.inlineMesh || {};
-        const loaded = args?.config !== void 0 ? { config: args.config, source: "inline", sourceType: "mesh_policy" } : loadMeshRefineConfig(mesh, workspace);
-        const validation = loaded.config ? validateMeshRefineConfig(loaded.config, loaded.source) : { valid: false, errors: [loaded.error || "repo mesh/refine config unavailable"], commands: [], rejectedCommands: [] };
-        return { success: validation.valid, ...loaded, ...validation };
-      }
-      case "suggest_mesh_refine_config": {
-        const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
-        const mesh = args?.inlineMesh || {};
-        return {
-          success: true,
-          ...suggestMeshRefineConfig(mesh, workspace),
-          note: "Suggestions are heuristic scaffold only; Refinery will not execute them until saved into repo mesh/refine config."
-        };
-      }
-      case "get_mesh_change_impact_config_schema": {
-        return {
-          success: true,
-          schema: CHANGE_IMPACT_CONFIG_SCHEMA,
-          locations: CHANGE_IMPACT_CONFIG_LOCATIONS,
-          sourceOfTruth: "repo change-impact config",
-          heuristicRole: "suggestions_only_not_execution_path",
-          note: "Declarative config only \u2014 JSON/YAML are parsed but never executed. Defines which package/file changes require a daemon rebuild/restart vs. a web-only redeploy vs. nothing."
-        };
-      }
-      case "validate_mesh_change_impact_config": {
-        const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
-        if (args?.config !== void 0) {
-          const validation = validateChangeImpactConfig(args.config, "inline");
-          return { success: validation.valid, source: "inline", sourceType: "mesh_policy", ...validation };
-        }
-        const loaded = loadChangeImpactConfig(workspace);
-        if (loaded.sourceType === "repo_file") {
-          const validation = validateChangeImpactConfig(loaded.config, loaded.source);
-          return { success: validation.valid, ...loaded, ...validation };
-        }
-        return {
-          success: false,
-          ...loaded,
-          valid: false,
-          errors: [loaded.error || "repo change-impact config unavailable"]
-        };
-      }
-      case "suggest_mesh_change_impact_config": {
-        const workspace = typeof args?.workspace === "string" ? args.workspace : process.cwd();
-        return {
-          success: true,
-          ...suggestChangeImpactConfig(workspace),
-          note: "Suggestions are heuristic scaffold only; the draft must be reviewed and saved into repo change-impact config before it takes effect. Nothing is executed."
-        };
-      }
       case "mesh_init": {
         const workspace = typeof args?.workspace === "string" && args.workspace.trim() ? args.workspace.trim() : process.cwd();
         const mesh = args?.inlineMesh || {};
@@ -52157,7 +52223,7 @@ ${ptyResult.output.slice(-2e3)}`);
             const isSelfNode = Boolean(
               nodeId && inlineCoordinatorNodeId && nodeId === inlineCoordinatorNodeId
             ) || Boolean(
-              daemonId && (daemonId === localMachineId || daemonId === this.deps.statusInstanceId)
+              daemonId && (daemonIdsEquivalent(daemonId, localMachineId) || daemonIdsEquivalent(daemonId, this.deps.statusInstanceId))
             ) || Boolean(meshRecord?.inline && nodeIndex === 0) || sparseConfiguredCoordinatorNode;
             const machineIdentity = buildMeshNodeMachineIdentity(node, {
               localMachineId,