@phenx-inc/ctlsurf 0.9.0 → 0.10.0

package/out/renderer/assets/{index-Cj7K9-Ba.js → index-Dg1vMspf.js}

@@ -1,4 +1,4 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["./cssMode-BdYp0fp9.js","./lspLanguageFeatures-8SIcRAMh.js","./htmlMode-CCm0aJ6C.js","./jsonMode-BgCUHaFo.js","./javascript-B2niCouI.js","./typescript-rdwAjCi4.js"])))=>i.map(i=>d[i]);
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["./cssMode-BbCVOTaJ.js","./lspLanguageFeatures-Dmx0L0Bw.js","./htmlMode-C7PzhXxH.js","./jsonMode-BtZtt3QW.js","./javascript-Cy7ROXJl.js","./typescript-Dysz1PTX.js"])))=>i.map(i=>d[i]);
 function getDefaultExportFromCjs(x) {
   return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
 }
@@ -207841,7 +207841,7 @@ const lessDefaults = new LanguageServiceDefaultsImpl$3(
   modeConfigurationDefault$2
 );
 function getMode$3() {
-  return __vitePreload(() => import("./cssMode-BdYp0fp9.js"), true ? __vite__mapDeps([0,1]) : void 0, import.meta.url);
+  return __vitePreload(() => import("./cssMode-BbCVOTaJ.js"), true ? __vite__mapDeps([0,1]) : void 0, import.meta.url);
 }
 languages.onLanguage("less", () => {
   getMode$3().then((mode2) => mode2.setupMode(lessDefaults));
@@ -207946,7 +207946,7 @@ const razorLanguageService = registerHTMLLanguageService(
 );
 const razorDefaults = razorLanguageService.defaults;
 function getMode$2() {
-  return __vitePreload(() => import("./htmlMode-CCm0aJ6C.js"), true ? __vite__mapDeps([2,1]) : void 0, import.meta.url);
+  return __vitePreload(() => import("./htmlMode-C7PzhXxH.js"), true ? __vite__mapDeps([2,1]) : void 0, import.meta.url);
 }
 function registerHTMLLanguageService(languageId, options = optionsDefault, modeConfiguration = getConfigurationDefault(languageId)) {
   const defaults = new LanguageServiceDefaultsImpl$2(languageId, options, modeConfiguration);
@@ -208030,7 +208030,7 @@ const jsonDefaults = new LanguageServiceDefaultsImpl$1(
 );
 const getWorker$1 = () => getMode$1().then((mode2) => mode2.getWorker());
 function getMode$1() {
-  return __vitePreload(() => import("./jsonMode-BgCUHaFo.js"), true ? __vite__mapDeps([3,1]) : void 0, import.meta.url);
+  return __vitePreload(() => import("./jsonMode-BtZtt3QW.js"), true ? __vite__mapDeps([3,1]) : void 0, import.meta.url);
 }
 languages.register({
   id: "json",
@@ -208276,7 +208276,7 @@ const getJavaScriptWorker = () => {
   return getMode().then((mode) => mode.getJavaScriptWorker());
 };
 function getMode() {
-  return __vitePreload(() => import("./tsMode-8FLRnobw.js"), true ? [] : void 0, import.meta.url);
+  return __vitePreload(() => import("./tsMode-Dqd8vdLE.js"), true ? [] : void 0, import.meta.url);
 }
 languages.onLanguage("typescript", () => {
   return getMode().then((mode) => mode.setupTypeScript(typescriptDefaults));
@@ -208471,49 +208471,49 @@ registerLanguage({
   extensions: [".ftl", ".ftlh", ".ftlx"],
   aliases: ["FreeMarker2", "Apache FreeMarker2"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAutoInterpolationDollar);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAutoInterpolationDollar);
   }
 });
 registerLanguage({
   id: "freemarker2.tag-angle.interpolation-dollar",
   aliases: ["FreeMarker2 (Angle/Dollar)", "Apache FreeMarker2 (Angle/Dollar)"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAngleInterpolationDollar);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAngleInterpolationDollar);
   }
 });
 registerLanguage({
   id: "freemarker2.tag-bracket.interpolation-dollar",
   aliases: ["FreeMarker2 (Bracket/Dollar)", "Apache FreeMarker2 (Bracket/Dollar)"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagBracketInterpolationDollar);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagBracketInterpolationDollar);
   }
 });
 registerLanguage({
   id: "freemarker2.tag-angle.interpolation-bracket",
   aliases: ["FreeMarker2 (Angle/Bracket)", "Apache FreeMarker2 (Angle/Bracket)"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAngleInterpolationBracket);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAngleInterpolationBracket);
   }
 });
 registerLanguage({
   id: "freemarker2.tag-bracket.interpolation-bracket",
   aliases: ["FreeMarker2 (Bracket/Bracket)", "Apache FreeMarker2 (Bracket/Bracket)"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagBracketInterpolationBracket);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagBracketInterpolationBracket);
   }
 });
 registerLanguage({
   id: "freemarker2.tag-auto.interpolation-dollar",
   aliases: ["FreeMarker2 (Auto/Dollar)", "Apache FreeMarker2 (Auto/Dollar)"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAutoInterpolationDollar);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAutoInterpolationDollar);
   }
 });
 registerLanguage({
   id: "freemarker2.tag-auto.interpolation-bracket",
   aliases: ["FreeMarker2 (Auto/Bracket)", "Apache FreeMarker2 (Auto/Bracket)"],
   loader: () => {
-    return __vitePreload(() => import("./freemarker2-Cya-9zr-.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAutoInterpolationBracket);
+    return __vitePreload(() => import("./freemarker2-DryLywQv.js"), true ? [] : void 0, import.meta.url).then((m) => m.TagAutoInterpolationBracket);
   }
 });
 registerLanguage({
@@ -208534,7 +208534,7 @@ registerLanguage({
   extensions: [".handlebars", ".hbs"],
   aliases: ["Handlebars", "handlebars", "hbs"],
   mimetypes: ["text/x-handlebars-template"],
-  loader: () => __vitePreload(() => import("./handlebars-EJs9W5Ub.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./handlebars-CdUMtSdr.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "hcl",
@@ -208547,7 +208547,7 @@ registerLanguage({
   extensions: [".html", ".htm", ".shtml", ".xhtml", ".mdoc", ".jsp", ".asp", ".aspx", ".jshtm"],
   aliases: ["HTML", "htm", "html", "xhtml"],
   mimetypes: ["text/html", "text/x-jshtm", "text/template", "text/ng-template"],
-  loader: () => __vitePreload(() => import("./html-Ex4qy2lh.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./html-Cwkf2GMH.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "ini",
@@ -208570,7 +208570,7 @@ registerLanguage({
   filenames: ["jakefile"],
   aliases: ["JavaScript", "javascript", "js"],
   mimetypes: ["text/javascript"],
-  loader: () => __vitePreload(() => import("./javascript-B2niCouI.js"), true ? __vite__mapDeps([4,5]) : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./javascript-Cy7ROXJl.js"), true ? __vite__mapDeps([4,5]) : void 0, import.meta.url)
 });
 registerLanguage({
   id: "julia",
@@ -208609,7 +208609,7 @@ registerLanguage({
   extensions: [".liquid", ".html.liquid"],
   aliases: ["Liquid", "liquid"],
   mimetypes: ["application/liquid"],
-  loader: () => __vitePreload(() => import("./liquid-DOQmSo4G.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./liquid-xReAQeYs.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "m3",
@@ -208627,7 +208627,7 @@ registerLanguage({
   id: "mdx",
   extensions: [".mdx"],
   aliases: ["MDX", "mdx"],
-  loader: () => __vitePreload(() => import("./mdx-DuKdGNKE.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./mdx-YMNFO1Zz.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "mips",
@@ -208726,7 +208726,7 @@ registerLanguage({
   extensions: [".py", ".rpy", ".pyw", ".cpy", ".gyp", ".gypi"],
   aliases: ["Python", "py"],
   firstLine: "^#!/.*\\bpython[0-9.-]*\\b",
-  loader: () => __vitePreload(() => import("./python-BUa4XFG-.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./python-BExaDVxv.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "qsharp",
@@ -208745,7 +208745,7 @@ registerLanguage({
   extensions: [".cshtml"],
   aliases: ["Razor", "razor"],
   mimetypes: ["text/x-cshtml"],
-  loader: () => __vitePreload(() => import("./razor-BUw8jho0.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./razor-HL8ANmQ4.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "redis",
@@ -208878,7 +208878,7 @@ registerLanguage({
   aliases: ["TypeScript", "ts", "typescript"],
   mimetypes: ["text/typescript"],
   loader: () => {
-    return __vitePreload(() => import("./typescript-rdwAjCi4.js"), true ? [] : void 0, import.meta.url);
+    return __vitePreload(() => import("./typescript-Dysz1PTX.js"), true ? [] : void 0, import.meta.url);
   }
 });
 registerLanguage({
@@ -208923,14 +208923,14 @@ registerLanguage({
   firstLine: "(\\<\\?xml.*)|(\\<svg)|(\\<\\!doctype\\s+svg)",
   aliases: ["XML", "xml"],
   mimetypes: ["text/xml", "application/xml", "application/xaml+xml", "application/xml-dtd"],
-  loader: () => __vitePreload(() => import("./xml-HOzT59Qg.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./xml-BHp5Z9nc.js"), true ? [] : void 0, import.meta.url)
 });
 registerLanguage({
   id: "yaml",
   extensions: [".yaml", ".yml"],
   aliases: ["YAML", "yaml", "YML", "yml"],
   mimetypes: ["application/x-yaml", "text/x-yaml"],
-  loader: () => __vitePreload(() => import("./yaml-B81JfLsW.js"), true ? [] : void 0, import.meta.url)
+  loader: () => __vitePreload(() => import("./yaml-CPDHxVup.js"), true ? [] : void 0, import.meta.url)
 });
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -213332,6 +213332,7 @@ function App() {
   });
   const [activeTabId, setActiveTabId] = reactExports.useState(tabs[0].id);
   const [trackingActive, setTrackingActive] = reactExports.useState(false);
+  const [agentStates, setAgentStates] = reactExports.useState({});
   const [showTicketPanel, setShowTicketPanel] = reactExports.useState(false);
   const [showFloatingMic, setShowFloatingMic] = reactExports.useState(() => {
     try {
@@ -213394,6 +213395,13 @@ function App() {
     });
     return unsub;
   }, []);
+  reactExports.useEffect(() => {
+    const unsub = window.worker.onAgentState((tabId, state) => {
+      if (!tabId) return;
+      setAgentStates((prev) => prev[tabId] === state ? prev : { ...prev, [tabId]: state });
+    });
+    return unsub;
+  }, []);
   reactExports.useEffect(() => {
     let cancelled = false;
     const refresh = async () => {
@@ -213585,8 +213593,7 @@ function App() {
               children: [
                 /* @__PURE__ */ jsxRuntimeExports.jsxs("span", { className: "terminal-tab-label", children: [
                   tab.agent ? tab.agent.name : tab.label,
-                  tab.agentStatus === "active" && /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "terminal-tab-dot active" }),
-                  tab.agentStatus === "exited" && /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "terminal-tab-dot exited" })
+                  tab.agentStatus === "exited" ? /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "terminal-tab-dot exited" }) : agentStates[tab.id] === "awaiting_decision" ? /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "terminal-tab-dot decision", title: "Awaiting your approval" }) : agentStates[tab.id] === "awaiting_input" ? /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "terminal-tab-dot awaiting", title: "Awaiting your input" }) : tab.agentStatus === "active" ? /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "terminal-tab-dot active" }) : null
                 ] }),
                 tabs.length > 1 && /* @__PURE__ */ jsxRuntimeExports.jsx(
                   "button",

package/out/renderer/assets/{javascript-B2niCouI.js → javascript-Cy7ROXJl.js}

@@ -1,5 +1,5 @@
-import { conf as conf$1, language as language$1 } from "./typescript-rdwAjCi4.js";
-import "./index-Cj7K9-Ba.js";
+import { conf as conf$1, language as language$1 } from "./typescript-Dysz1PTX.js";
+import "./index-Dg1vMspf.js";
 const conf = conf$1;
 const language = {
   // Set defaultToken to invalid to see what you do not tokenize yet

package/out/renderer/assets/{jsonMode-BgCUHaFo.js → jsonMode-BtZtt3QW.js}

@@ -1,6 +1,6 @@
-import { c as createWebWorker, l as languages, e as editor } from "./index-Cj7K9-Ba.js";
-import { f as DocumentFormattingEditProvider, g as DocumentRangeFormattingEditProvider, C as CompletionAdapter, H as HoverAdapter, b as DocumentSymbolAdapter, d as DocumentColorAdapter, F as FoldingRangeAdapter, S as SelectionRangeAdapter, e as DiagnosticsAdapter } from "./lspLanguageFeatures-8SIcRAMh.js";
-import { a, D, h, R, c, i, j, t, k } from "./lspLanguageFeatures-8SIcRAMh.js";
+import { c as createWebWorker, l as languages, e as editor } from "./index-Dg1vMspf.js";
+import { f as DocumentFormattingEditProvider, g as DocumentRangeFormattingEditProvider, C as CompletionAdapter, H as HoverAdapter, b as DocumentSymbolAdapter, d as DocumentColorAdapter, F as FoldingRangeAdapter, S as SelectionRangeAdapter, e as DiagnosticsAdapter } from "./lspLanguageFeatures-Dmx0L0Bw.js";
+import { a, D, h, R, c, i, j, t, k } from "./lspLanguageFeatures-Dmx0L0Bw.js";
 const STOP_WHEN_IDLE_FOR = 2 * 60 * 1e3;
 class WorkerManager {
   constructor(defaults) {

package/out/renderer/assets/{liquid-DOQmSo4G.js → liquid-xReAQeYs.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const EMPTY_ELEMENTS = [
   "area",
   "base",

package/out/renderer/assets/{lspLanguageFeatures-8SIcRAMh.js → lspLanguageFeatures-Dmx0L0Bw.js}

@@ -1,4 +1,4 @@
-import { R as Range$1, l as languages, e as editor, U as Uri, M as MarkerSeverity } from "./index-Cj7K9-Ba.js";
+import { R as Range$1, l as languages, e as editor, U as Uri, M as MarkerSeverity } from "./index-Dg1vMspf.js";
 var DocumentUri;
 (function(DocumentUri2) {
   function is(value) {

package/out/renderer/assets/{mdx-DuKdGNKE.js → mdx-YMNFO1Zz.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const conf = {
   comments: {
     blockComment: ["{/*", "*/}"]

package/out/renderer/assets/{python-BUa4XFG-.js → python-BExaDVxv.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const conf = {
   comments: {
     lineComment: "#",

package/out/renderer/assets/{razor-BUw8jho0.js → razor-HL8ANmQ4.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const EMPTY_ELEMENTS = [
   "area",
   "base",

package/out/renderer/assets/{tsMode-8FLRnobw.js → tsMode-Dqd8vdLE.js}

@@ -1,4 +1,4 @@
-import { c as createWebWorker, e as editor, U as Uri, a as MarkerTag, M as MarkerSeverity, l as languages, t as typescriptDefaults, R as Range } from "./index-Cj7K9-Ba.js";
+import { c as createWebWorker, e as editor, U as Uri, a as MarkerTag, M as MarkerSeverity, l as languages, t as typescriptDefaults, R as Range } from "./index-Dg1vMspf.js";
 class WorkerManager {
   constructor(_modeId, _defaults) {
     this._modeId = _modeId;

package/out/renderer/assets/{typescript-rdwAjCi4.js → typescript-Dysz1PTX.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const conf = {
   wordPattern: /(-?\d*\.\d\w*)|([^\`\~\!\@\#\%\^\&\*\(\)\-\=\+\[\{\]\}\\\|\;\:\'\"\,\.\<\>\/\?\s]+)/g,
   comments: {

package/out/renderer/assets/{xml-HOzT59Qg.js → xml-BHp5Z9nc.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const conf = {
   comments: {
     blockComment: ["<!--", "-->"]

package/out/renderer/assets/{yaml-B81JfLsW.js → yaml-CPDHxVup.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-Cj7K9-Ba.js";
+import { l as languages } from "./index-Dg1vMspf.js";
 const conf = {
   comments: {
     lineComment: "#"

package/out/renderer/index.html

@@ -49,8 +49,8 @@
       color: #565f89;
     }
   </style>
-  <script type="module" crossorigin src="./assets/index-Cj7K9-Ba.js"></script>
-  <link rel="stylesheet" crossorigin href="./assets/index-nvsNYP5c.css">
+  <script type="module" crossorigin src="./assets/index-Dg1vMspf.js"></script>
+  <link rel="stylesheet" crossorigin href="./assets/index-BIceGcz3.css">
 </head>
 <body>
   <div id="boot-splash">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenx-inc/ctlsurf",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Agent-agnostic terminal and desktop app for ctlsurf — run Claude Code, Codex, or any coding agent with live session logging and remote control",
   "main": "out/main/index.js",
   "bin": {

package/src/main/agentState.ts

@@ -0,0 +1,329 @@
+/**
+ * Agent State Monitor
+ *
+ * Detects, in real time, whether a coding agent is BUSY (actively working) or
+ * AWAITING the user — either waiting for the next prompt (`awaiting_input`) or
+ * blocked on an approval/permission decision (`awaiting_decision`).
+ *
+ * This is the cross-platform "PTY backbone": it watches the raw terminal byte
+ * stream (which every agent produces regardless of OS) and infers state from
+ * the TUI's own affordances — the busy spinner (`esc to interrupt`) and
+ * approval prompts. It is deliberately independent of chat logging and of the
+ * ConversationBridge, whose transcript cleaner actively *discards* the spinner
+ * lines this monitor needs.
+ *
+ * Agents with native hooks (Claude Code, Codex) can deliver an authoritative
+ * state via `applyHookEvent()`, which overrides the heuristic for a short
+ * window. See agentHooks.ts.
+ */
+
+export type AgentState = 'idle' | 'busy' | 'awaiting_input' | 'awaiting_decision'
+
+export type AgentStateSink = (info: {
+  tabId: string
+  state: AgentState
+  /** True when any tracked tab is awaiting the user (drives the dock/taskbar). */
+  anyAwaiting: boolean
+}) => void
+
+// The spinner ticks roughly once per second; allow a couple of missed ticks
+// before we stop considering the agent busy.
+const BUSY_GRACE_MS = 2_500
+// Output must be quiet this long after the spinner stops before we declare the
+// agent is awaiting the user (avoids flagging mid-stream pauses).
+const SETTLE_MS = 1_200
+// How long a seen approval prompt keeps a tab in `awaiting_decision`.
+const DECISION_TTL_MS = 4_000
+// Evaluation cadence.
+const TICK_MS = 400
+// A hook-delivered state is authoritative for this long, suppressing the
+// heuristic for that tab.
+const HOOK_AUTHORITY_MS = 6_000
+// Only the trailing slice of each tab's output is kept, enough to catch a
+// marker split across two PTY chunks.
+const TAIL_KEEP_CHARS = 240
+
+// Claude Code's working spinner: a cycling star glyph followed by a gerund that
+// ends in an ellipsis, e.g. "✶ Tempering…" or "✳ Cogitating...". The completion
+// line ("✻ Worked for 2s") has the glyph but no ellipsis, so it doesn't match —
+// letting the agent settle to `awaiting_input`. Newer Claude builds (Opus 4.8)
+// don't always print "esc to interrupt" for fast turns, so this is the primary
+// Claude signal; the older hints are kept for other builds and Codex.
+const CLAUDE_SPINNER = /[✶✻✳✺✢✷✸✹❋][^\n]{0,60}(?:…|\.\.\.)/
+
+/** Busy markers — the spinner/working hints a TUI shows while actively working. */
+function hasBusyMarker(text: string): boolean {
+  return (
+    /esc to interrupt/i.test(text) ||
+    /\bWorking \(\d+s/i.test(text) ||
+    CLAUDE_SPINNER.test(text)
+  )
+}
+
+/**
+ * Approval / permission prompts. Conservative on purpose: a false positive only
+ * mislabels the sub-state (the dock fires on either awaiting state anyway), but
+ * we still avoid obviously-noisy matches.
+ */
+const APPROVAL_PATTERNS: RegExp[] = [
+  /\bDo you want to (proceed|continue|create|make this edit|run)\b/i, // Claude Code
+  /❯\s*\d+\.\s*Yes\b/i, // Claude numbered-choice prompt
+  /\bAllow command\b/i, // Codex
+  /\bRun this command\?/i, // Codex
+  /\bApprove\b[^\n]*\?/i,
+  /\(y\/n\)/i,
+  /\[y\/N\]/i,
+]
+
+function hasApprovalMarker(text: string): boolean {
+  return APPROVAL_PATTERNS.some((re) => re.test(text))
+}
+
+/** Strip CSI/OSC escape sequences so markers aren't hidden behind color codes. */
+function stripAnsi(str: string): string {
+  return str
+    // eslint-disable-next-line no-control-regex
+    .replace(/\x1b\[[\x30-\x3f]*[\x20-\x2f]*[\x40-\x7e]/g, '')
+    // eslint-disable-next-line no-control-regex
+    .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
+    // eslint-disable-next-line no-control-regex
+    .replace(/\x1b/g, '')
+}
+
+interface TabRecord {
+  /** Agent id (e.g. 'claude', 'codex'); reserved for future per-agent tuning. */
+  agentId: string
+  cwd: string
+  state: AgentState
+  /** True once a busy spinner has been seen since the last user input. */
+  everBusy: boolean
+  lastBusyAt: number
+  lastOutputAt: number
+  lastDecisionAt: number
+  /** Authoritative state from a hook, and when it was delivered. */
+  hookState: AgentState | null
+  hookAt: number
+  /** Trailing output slice, to catch markers split across PTY chunks. */
+  tail: string
+}
+
+export class AgentStateMonitor {
+  private readonly sink: AgentStateSink
+  private readonly now: () => number
+  private tabs = new Map<string, TabRecord>()
+  private timer: ReturnType<typeof setInterval> | null = null
+  private lastAnyAwaiting = false
+
+  constructor(sink: AgentStateSink, now: () => number = Date.now) {
+    this.sink = sink
+    this.now = now
+  }
+
+  start(): void {
+    if (this.timer) return
+    this.timer = setInterval(() => this.tick(), TICK_MS)
+  }
+
+  stop(): void {
+    if (this.timer) {
+      clearInterval(this.timer)
+      this.timer = null
+    }
+    this.tabs.clear()
+    this.lastAnyAwaiting = false
+  }
+
+  /** Register a tab so its raw PTY output can be classified. */
+  trackTab(tabId: string, agentId: string, cwd: string): void {
+    const now = this.now()
+    this.tabs.set(tabId, {
+      agentId,
+      cwd,
+      state: 'idle',
+      everBusy: false,
+      lastBusyAt: 0,
+      lastOutputAt: now,
+      lastDecisionAt: 0,
+      hookState: null,
+      hookAt: 0,
+      tail: '',
+    })
+  }
+
+  removeTab(tabId: string): void {
+    if (this.tabs.delete(tabId)) this.emitAggregate()
+  }
+
+  /** Feed a raw PTY output chunk for a tab. */
+  feed(tabId: string, data: string): void {
+    const rec = this.tabs.get(tabId)
+    if (!rec) return
+    const now = this.now()
+    rec.lastOutputAt = now
+
+    const text = rec.tail + stripAnsi(data)
+    rec.tail = text.length > TAIL_KEEP_CHARS ? text.slice(-TAIL_KEEP_CHARS) : text
+
+    if (hasBusyMarker(text)) {
+      rec.lastBusyAt = now
+      rec.everBusy = true
+    }
+    if (hasApprovalMarker(text)) {
+      rec.lastDecisionAt = now
+    }
+  }
+
+  /**
+   * Note input written to a tab's PTY. Only a *submit* (data containing a
+   * newline) counts as the user engaging — clearing any awaiting state and
+   * resetting the "has worked" flag so a leftover idle box doesn't re-flag.
+   *
+   * Individual keystrokes and, crucially, the terminal's own auto-responses
+   * (cursor-position / device-attribute replies that TUIs constantly trigger,
+   * which xterm.js writes straight back to the PTY) are ignored — otherwise
+   * the state would churn busy↔idle on every control-sequence handshake.
+   */
+  noteInput(tabId: string, data: string): void {
+    if (!/[\r\n]/.test(data)) return
+    const rec = this.tabs.get(tabId)
+    if (!rec) return
+    const now = this.now()
+    rec.everBusy = false
+    rec.lastBusyAt = now // a submit means work is coming → busy, not awaiting
+    rec.lastDecisionAt = 0
+    rec.hookState = null
+    this.setState(rec, tabId, 'busy')
+  }
+
+  /**
+   * Apply an authoritative state from an agent hook, addressed by cwd. Overrides
+   * the heuristic for HOOK_AUTHORITY_MS. `kind`:
+   *   'awaiting_input'    — turn done / idle prompt (Stop, idle_prompt, agent-turn-complete)
+   *   'awaiting_decision' — permission/approval prompt (PermissionRequest, permission_prompt)
+   *   'busy'              — user submitted a prompt (UserPromptSubmit)
+   */
+  applyHookEvent(cwd: string, kind: AgentState): void {
+    const target = stripTrailingSep(cwd)
+    const now = this.now()
+    for (const [tabId, rec] of this.tabs) {
+      if (stripTrailingSep(rec.cwd) !== target) continue
+      rec.hookState = kind
+      rec.hookAt = now
+      if (kind === 'busy') {
+        rec.everBusy = false
+        rec.lastBusyAt = now
+      }
+      this.setState(rec, tabId, kind)
+    }
+  }
+
+  private tick(): void {
+    const now = this.now()
+    for (const [tabId, rec] of this.tabs) {
+      // Hook state wins while fresh.
+      if (rec.hookState && now - rec.hookAt < HOOK_AUTHORITY_MS) {
+        this.setState(rec, tabId, rec.hookState)
+        continue
+      }
+
+      // `> 0` guards the "never seen" sentinel so a small/zero clock value
+      // doesn't read as recent activity.
+      const busyRecently = rec.lastBusyAt > 0 && now - rec.lastBusyAt < BUSY_GRACE_MS
+      const settled = now - rec.lastOutputAt >= SETTLE_MS
+      const decisionRecent = rec.lastDecisionAt > 0 && now - rec.lastDecisionAt < DECISION_TTL_MS
+
+      let next: AgentState | null = null
+      if (busyRecently) {
+        next = 'busy'
+      } else if (settled && rec.everBusy) {
+        // Awaiting the user. Keep the sub-state stable: once we're showing
+        // awaiting_decision it sticks (and awaiting_input may upgrade to it),
+        // but we never flap back down — the agent's screen repaints make an
+        // approval marker match only intermittently, which otherwise flickers
+        // the indicator between amber and red.
+        next = rec.state === 'awaiting_decision' || decisionRecent
+          ? 'awaiting_decision'
+          : 'awaiting_input'
+      } else if (settled && !rec.everBusy) {
+        next = 'idle'
+      }
+      // next === null → output still streaming after spinner stopped; hold the
+      // current state until it settles.
+      if (next) this.setState(rec, tabId, next)
+    }
+    this.emitAggregate()
+  }
+
+  private setState(rec: TabRecord, tabId: string, state: AgentState): void {
+    if (rec.state === state) return
+    rec.state = state
+    this.sink({ tabId, state, anyAwaiting: this.computeAnyAwaiting() })
+    this.lastAnyAwaiting = this.computeAnyAwaiting()
+  }
+
+  private emitAggregate(): void {
+    const anyAwaiting = this.computeAnyAwaiting()
+    if (anyAwaiting === this.lastAnyAwaiting) return
+    this.lastAnyAwaiting = anyAwaiting
+    // Re-emit with a representative tab so the dock/aggregate listener updates
+    // even when no single tab's state label changed this tick.
+    const tabId = this.firstAwaitingTabId() ?? ''
+    const state = tabId ? (this.tabs.get(tabId)!.state) : 'idle'
+    this.sink({ tabId, state, anyAwaiting })
+  }
+
+  private computeAnyAwaiting(): boolean {
+    for (const rec of this.tabs.values()) {
+      if (rec.state === 'awaiting_input' || rec.state === 'awaiting_decision') return true
+    }
+    return false
+  }
+
+  private firstAwaitingTabId(): string | null {
+    for (const [tabId, rec] of this.tabs) {
+      if (rec.state === 'awaiting_input' || rec.state === 'awaiting_decision') return tabId
+    }
+    return null
+  }
+}
+
+function stripTrailingSep(p: string): string {
+  return p.length > 1 ? p.replace(/[/\\]+$/, '') : p
+}
+
+/**
+ * Decides whether the dock/taskbar "awaiting input" attention (blink + bounce)
+ * should currently be active. Pure boolean logic, separated from the Electron
+ * bindings in index.ts so it can be tested without a window.
+ *
+ * Rules:
+ *  - Attention is active only while an agent is awaiting AND the window is
+ *    unfocused AND the current awaiting episode hasn't been acknowledged.
+ *  - Focusing the window during an episode acknowledges it; so does already
+ *    being focused at the moment the episode begins (you saw it happen).
+ *  - Acknowledgement lasts for the whole episode: blurring again does NOT
+ *    re-nag. A fresh episode (agent works, then waits again) starts unack'd.
+ */
+export class AttentionController {
+  private awaiting = false
+  private focused = false
+  private acknowledged = false
+
+  /** Update awaiting state; returns whether attention should be active. */
+  setAwaiting(on: boolean): boolean {
+    if (on && !this.awaiting) this.acknowledged = this.focused // new episode
+    this.awaiting = on
+    return this.active()
+  }
+
+  /** Update window focus; returns whether attention should be active. */
+  setFocused(focused: boolean): boolean {
+    this.focused = focused
+    if (focused && this.awaiting) this.acknowledged = true
+    return this.active()
+  }
+
+  private active(): boolean {
+    return this.awaiting && !this.focused && !this.acknowledged
+  }
+}