@dexto/tui 1.14.6 → 1.15.0-beta.1

package/dist/services/processStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processStream.d.ts","sourceRoot":"","sources":["../../src/services/processStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAGvE,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAc,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAoEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,2DAA2D;IAC3D,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,oFAAoF;IACpF,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpE,iFAAiF;IACjF,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,kEAAkE;IAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3F,4CAA4C;IAC5C,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAC9F,2CAA2C;IAC3C,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAC/F,4DAA4D;IAC5D,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1E,uDAAuD;IACvD,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;CAC7E;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2FAA2F;IAC3F,mBAAmB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1C,wFAAwF;IACxF,oBAAoB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,EAAE,IAAI,CAAC,OAAO,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,+BAA+B,EAAE,wBAAwB,CAAC;IAChF,kEAAkE;IAClE,QAAQ,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;CAC3F;AAgDD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,qBAAqB,CAAC,cAAc,CAAC,EAC/C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAuvCf"}
+{"version":3,"file":"processStream.d.ts","sourceRoot":"","sources":["../../src/services/processStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAGvE,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAc,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AA2EvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,2DAA2D;IAC3D,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,oFAAoF;IACpF,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpE,iFAAiF;IACjF,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,kEAAkE;IAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3F,4CAA4C;IAC5C,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAC9F,2CAA2C;IAC3C,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAC/F,4DAA4D;IAC5D,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1E,uDAAuD;IACvD,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;CAC7E;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2FAA2F;IAC3F,mBAAmB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1C,wFAAwF;IACxF,oBAAoB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,EAAE,IAAI,CAAC,OAAO,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,+BAA+B,EAAE,wBAAwB,CAAC;IAChF,kEAAkE;IAClE,QAAQ,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;CAC3F;AAgDD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,qBAAqB,CAAC,cAAc,CAAC,EAC/C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAmwCf"}

package/dist/services/processStream.js

@@ -2,7 +2,8 @@ import { createDebugLogger } from "../utils/debugLog.js";
 import { ApprovalType as ApprovalTypeEnum, ApprovalStatus, LLMErrorCode } from "@dexto/core";
 import { generateMessageId } from "../utils/idGenerator.js";
 import { checkForSplit } from "../utils/streamSplitter.js";
-import { formatToolHeader, shouldHideTool } from "../utils/messageFormatting.js";
+import { backgroundFailure } from "../utils/tool-step.js";
+import { formatToolHeader } from "../utils/messageFormatting.js";
 import { isAutoApprovableInEditMode } from "../utils/toolUtils.js";
 import { captureAnalytics } from "../host/index.js";
 import chalk from "chalk";
@@ -15,6 +16,11 @@ function buildErrorContent(error, prefix) {
   }
   return errorContent;
 }
+function isReportedError(error, reported) {
+  if (reported.has(error)) return true;
+  if (!(error instanceof Error)) return false;
+  return [...reported].some((each) => each instanceof Error && each.message === error.message);
+}
 function getErrorCode(error) {
   if (typeof error !== "object" || error === null) {
     return null;
@@ -48,9 +54,9 @@ function extractInsufficientCreditsBalance(error) {
 }
 function buildInsufficientCreditsContent(balance) {
   if (balance === null) {
-    return "Out of Dexto Nova credits.\nUse the billing prompt to top up and retry your request.";
+    return "Out of Dexto credits.\nUse the billing prompt to top up and retry your request.";
   }
-  return `Out of Dexto Nova credits. Current balance: $${balance.toFixed(2)}.
+  return `Out of Dexto credits. Current balance: $${balance.toFixed(2)}.
 Use the billing prompt to top up and retry your request.`;
 }
 function hasMeaningfulTokenUsageForAnalytics(tokenUsage, estimatedCost) {
@@ -73,6 +79,7 @@ async function processStream(iterator, setters, options) {
   } = setters;
   const useStreaming = options?.useStreaming ?? true;
   const approvalIdToToolCallId = /* @__PURE__ */ new Map();
+  const reportedErrors = /* @__PURE__ */ new Set();
   const state = {
     messageId: null,
     content: "",
@@ -444,9 +451,6 @@ async function processStream(iterator, setters, options) {
           break;
         }
         case "llm:tool-call": {
-          if (shouldHideTool(event.toolName)) {
-            break;
-          }
           debug.log("TOOL-CALL: state check", {
             toolName: event.toolName,
             hasMessageId: !!state.messageId,
@@ -526,7 +530,7 @@ async function processStream(iterator, setters, options) {
             }
           }
           const toolMessageId = event.callId ? `tool-${event.callId}` : generateMessageId("tool");
-          const { header: toolContent } = formatToolHeader({
+          const { header: toolContent, argsFormatted: toolArgs } = formatToolHeader({
             toolName: event.toolName,
             args: event.args || {},
             ...event.presentationSnapshot !== void 0 && {
@@ -544,6 +548,8 @@ ${chalk.dim(runningDescription)}`;
             role: "tool",
             content: finalToolContent,
             timestamp: /* @__PURE__ */ new Date(),
+            toolName: event.toolName,
+            toolArgs,
             toolStatus: "pending"
           });
           captureAnalytics("dexto_tool_called", {
@@ -554,9 +560,6 @@ ${chalk.dim(runningDescription)}`;
           break;
         }
         case "llm:tool-result": {
-          if (shouldHideTool(event.toolName)) {
-            break;
-          }
           const sanitized = event.sanitized;
           const toolDisplayData = sanitized?.meta?.display;
           const toolContent = sanitized?.content;
@@ -595,6 +598,8 @@ ${chalk.dim(runningDescription)}`;
               toolResult: resultPreview,
               toolStatus: "finished",
               isError: !event.success,
+              ...backgroundFailure(event.toolName, event.rawResult),
+              ...!event.success && event.error !== void 0 && { toolFailureText: event.error },
               ...toolDisplayData && { toolDisplayData },
               ...toolContent && { toolContent }
             });
@@ -621,6 +626,7 @@ ${chalk.dim(runningDescription)}`;
           break;
         }
         case "llm:error": {
+          reportedErrors.add(event.error);
           const insufficientCredits = getErrorCode(event.error) === LLMErrorCode.INSUFFICIENT_CREDITS;
           const insufficientCreditsBalance = insufficientCredits ? extractInsufficientCreditsBalance(event.error) : null;
           const errorContent = insufficientCredits ? buildInsufficientCreditsContent(insufficientCreditsBalance) : buildErrorContent(event.error, "Error: ");
@@ -630,7 +636,8 @@ ${chalk.dim(runningDescription)}`;
               id: generateMessageId("error"),
               role: "system",
               content: errorContent,
-              timestamp: /* @__PURE__ */ new Date()
+              timestamp: /* @__PURE__ */ new Date(),
+              systemKind: "fault"
             }
           ]);
           if (event.recoverable !== true) {
@@ -820,7 +827,8 @@ ${chalk.dim(runningDescription)}`;
               finalizeMessage(`tool-${toolCallId}`, {
                 toolStatus: "finished",
                 toolResult: "Cancelled",
-                isError: true
+                isError: true,
+                toolOutcome: event.status === ApprovalStatus.DENIED ? "denied" : "cancelled"
               });
             }
           }
@@ -912,6 +920,7 @@ ${chalk.dim(runningDescription)}`;
           break;
       }
     }
+    setUi((prev) => prev.isCancelling ? { ...prev, isCancelling: false } : prev);
   } catch (error) {
     if (error instanceof Error && error.name === "AbortError") {
       clearPending();
@@ -923,16 +932,19 @@ ${chalk.dim(runningDescription)}`;
       }));
     } else {
       clearPending();
-      const errorContent = buildErrorContent(error, "Stream error: ");
-      setMessages((prev) => [
-        ...prev,
-        {
-          id: generateMessageId("error"),
-          role: "system",
-          content: errorContent,
-          timestamp: /* @__PURE__ */ new Date()
-        }
-      ]);
+      if (!isReportedError(error, reportedErrors)) {
+        const errorContent = buildErrorContent(error, "Stream error: ");
+        setMessages((prev) => [
+          ...prev,
+          {
+            id: generateMessageId("error"),
+            role: "system",
+            content: errorContent,
+            timestamp: /* @__PURE__ */ new Date(),
+            systemKind: "fault"
+          }
+        ]);
+      }
       setUi((prev) => ({
         ...prev,
         isProcessing: false,

package/dist/services/processStream.test.cjs

@@ -73,9 +73,6 @@ function createSetters({
     promptAddWizard: null,
     autoApproveEdits: false,
     todoExpanded: true,
-    backgroundTasksRunning: 0,
-    backgroundTasksExpanded: false,
-    backgroundTasks: [],
     chatgptRateLimitStatus: null,
     insufficientCredits: null,
     planModeActive: false,
@@ -477,6 +474,40 @@ function createSetters({
     (0, import_vitest.expect)(assistantMessages[1]?.content).toBe("Final");
     (0, import_vitest.expect)(assistantMessages[1]?.reasoning).toBeUndefined();
   });
+  (0, import_vitest.it)("reports a fatal error once when the stream rethrows it", async () => {
+    const { getMessages, setters } = createSetters();
+    const error = new Error("Provider error 500");
+    async function* failing() {
+      yield { name: "llm:error", sessionId: "test-session", error };
+      throw new Error("Provider error 500");
+    }
+    await (0, import_processStream.processStream)(failing(), setters, {
+      useStreaming: true,
+      autoApproveEditsRef: { current: false },
+      bypassPermissionsRef: { current: false },
+      eventBus: { emit: import_vitest.vi.fn() }
+    });
+    const faults = getMessages().filter((each) => each.content.includes("Provider error 500"));
+    (0, import_vitest.expect)(faults).toHaveLength(1);
+    (0, import_vitest.expect)(faults[0]?.systemKind).toBe("fault");
+  });
+  (0, import_vitest.it)("still reports a stream failure nothing has reported", async () => {
+    const { getMessages, setters } = createSetters();
+    async function* failing() {
+      yield* [];
+      throw new Error("socket closed");
+    }
+    await (0, import_processStream.processStream)(failing(), setters, {
+      useStreaming: true,
+      autoApproveEditsRef: { current: false },
+      bypassPermissionsRef: { current: false },
+      eventBus: { emit: import_vitest.vi.fn() }
+    });
+    (0, import_vitest.expect)(getMessages().at(-1)).toMatchObject({
+      content: "Stream error: socket closed",
+      systemKind: "fault"
+    });
+  });
   (0, import_vitest.it)("shows the billing recovery overlay for insufficient credits", async () => {
     const { getMessages, getUi, setters } = createSetters();
     const error = Object.assign(new Error("Insufficient Dexto credits. Balance: $0.00"), {
@@ -504,7 +535,7 @@ function createSetters({
     (0, import_vitest.expect)(ui.insufficientCredits).toEqual({ balanceUsd: 0 });
     (0, import_vitest.expect)(ui.isProcessing).toBe(false);
     const latestMessage = getMessages().at(-1);
-    (0, import_vitest.expect)(latestMessage?.content).toContain("Out of Dexto Nova credits");
+    (0, import_vitest.expect)(latestMessage?.content).toContain("Out of Dexto credits");
     (0, import_vitest.expect)(latestMessage?.content).not.toContain("Error:");
   });
   (0, import_vitest.it)("captures analytics cost fields for priced llm responses", async () => {
@@ -559,3 +590,20 @@ function createSetters({
     );
   });
 });
+(0, import_vitest.describe)("processStream (stop)", () => {
+  (0, import_vitest.it)("clears the stop state when a cancelled run ends its stream", async () => {
+    const { setters, getUi } = createSetters();
+    setters.setUi((prev) => ({ ...prev, isProcessing: false, isCancelling: true }));
+    await (0, import_processStream.processStream)(
+      eventStream([{ name: "llm:thinking", sessionId: "test-session" }]),
+      setters,
+      {
+        useStreaming: true,
+        autoApproveEditsRef: { current: false },
+        bypassPermissionsRef: { current: false },
+        eventBus: { emit: import_vitest.vi.fn() }
+      }
+    );
+    (0, import_vitest.expect)(getUi().isCancelling).toBe(false);
+  });
+});

package/dist/services/processStream.test.js

@@ -72,9 +72,6 @@ function createSetters({
     promptAddWizard: null,
     autoApproveEdits: false,
     todoExpanded: true,
-    backgroundTasksRunning: 0,
-    backgroundTasksExpanded: false,
-    backgroundTasks: [],
     chatgptRateLimitStatus: null,
     insufficientCredits: null,
     planModeActive: false,
@@ -476,6 +473,40 @@ describe("processStream (reasoning)", () => {
     expect(assistantMessages[1]?.content).toBe("Final");
     expect(assistantMessages[1]?.reasoning).toBeUndefined();
   });
+  it("reports a fatal error once when the stream rethrows it", async () => {
+    const { getMessages, setters } = createSetters();
+    const error = new Error("Provider error 500");
+    async function* failing() {
+      yield { name: "llm:error", sessionId: "test-session", error };
+      throw new Error("Provider error 500");
+    }
+    await processStream(failing(), setters, {
+      useStreaming: true,
+      autoApproveEditsRef: { current: false },
+      bypassPermissionsRef: { current: false },
+      eventBus: { emit: vi.fn() }
+    });
+    const faults = getMessages().filter((each) => each.content.includes("Provider error 500"));
+    expect(faults).toHaveLength(1);
+    expect(faults[0]?.systemKind).toBe("fault");
+  });
+  it("still reports a stream failure nothing has reported", async () => {
+    const { getMessages, setters } = createSetters();
+    async function* failing() {
+      yield* [];
+      throw new Error("socket closed");
+    }
+    await processStream(failing(), setters, {
+      useStreaming: true,
+      autoApproveEditsRef: { current: false },
+      bypassPermissionsRef: { current: false },
+      eventBus: { emit: vi.fn() }
+    });
+    expect(getMessages().at(-1)).toMatchObject({
+      content: "Stream error: socket closed",
+      systemKind: "fault"
+    });
+  });
   it("shows the billing recovery overlay for insufficient credits", async () => {
     const { getMessages, getUi, setters } = createSetters();
     const error = Object.assign(new Error("Insufficient Dexto credits. Balance: $0.00"), {
@@ -503,7 +534,7 @@ describe("processStream (reasoning)", () => {
     expect(ui.insufficientCredits).toEqual({ balanceUsd: 0 });
     expect(ui.isProcessing).toBe(false);
     const latestMessage = getMessages().at(-1);
-    expect(latestMessage?.content).toContain("Out of Dexto Nova credits");
+    expect(latestMessage?.content).toContain("Out of Dexto credits");
     expect(latestMessage?.content).not.toContain("Error:");
   });
   it("captures analytics cost fields for priced llm responses", async () => {
@@ -558,3 +589,20 @@ describe("processStream (reasoning)", () => {
     );
   });
 });
+describe("processStream (stop)", () => {
+  it("clears the stop state when a cancelled run ends its stream", async () => {
+    const { setters, getUi } = createSetters();
+    setters.setUi((prev) => ({ ...prev, isProcessing: false, isCancelling: true }));
+    await processStream(
+      eventStream([{ name: "llm:thinking", sessionId: "test-session" }]),
+      setters,
+      {
+        useStreaming: true,
+        autoApproveEditsRef: { current: false },
+        bypassPermissionsRef: { current: false },
+        eventBus: { emit: vi.fn() }
+      }
+    );
+    expect(getUi().isCancelling).toBe(false);
+  });
+});

package/dist/signal/background.cjs

@@ -0,0 +1,154 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var background_exports = {};
+__export(background_exports, {
+  BACKGROUND_QUERY: () => BACKGROUND_QUERY,
+  BACKGROUND_TIMEOUT_MS: () => BACKGROUND_TIMEOUT_MS,
+  createTerminalReplyFilter: () => createTerminalReplyFilter,
+  detectBackgroundTheme: () => detectBackgroundTheme,
+  parseBackgroundReply: () => parseBackgroundReply,
+  queryBackgroundTheme: () => queryBackgroundTheme,
+  shouldQueryBackground: () => shouldQueryBackground
+});
+module.exports = __toCommonJS(background_exports);
+var import_caps = require("./caps.js");
+const BACKGROUND_QUERY = "\x1B]11;?\x07\x1B[c";
+const BACKGROUND_TIMEOUT_MS = 250;
+const OSC11_REPLY = /\x1b\]11;rgba?:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})/i;
+const DA1_REPLY = /\x1b\[\?[\d;]*c/;
+function channel(hex) {
+  return parseInt(hex, 16) / (16 ** hex.length - 1);
+}
+function parseBackgroundReply(data) {
+  const match = OSC11_REPLY.exec(data);
+  if (match === null) return null;
+  const [r, g, b] = [match[1], match[2], match[3]].map((hex) => channel(hex ?? ""));
+  if (r === void 0 || g === void 0 || b === void 0) return null;
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b >= 0.5 ? "light" : "dark";
+}
+function shouldQueryBackground(caps, stdinIsTTY) {
+  return caps.palette === "signal" && caps.color !== "none" && caps.tty && stdinIsTTY;
+}
+function queryBackgroundTheme(io, timeoutMs) {
+  const { stdin, stdout } = io;
+  const wasRaw = stdin.isRaw === true;
+  return new Promise((resolve) => {
+    let received = "";
+    const finish = () => {
+      clearTimeout(timer);
+      stdin.removeListener("data", onData);
+      stdin.setRawMode?.(wasRaw);
+      stdin.pause();
+      const { keys, held } = stripReplies(received);
+      const rest = keys + held;
+      if (rest !== "") stdin.unshift(Buffer.from(rest, "latin1"));
+      resolve(parseBackgroundReply(received));
+    };
+    const onData = (chunk) => {
+      received += (typeof chunk === "string" ? Buffer.from(chunk) : chunk).toString("latin1");
+      if (DA1_REPLY.test(received)) finish();
+    };
+    const timer = setTimeout(finish, timeoutMs);
+    stdin.setRawMode?.(true);
+    stdin.on("data", onData);
+    stdin.resume();
+    stdout.write(BACKGROUND_QUERY);
+  });
+}
+const MAX_REPLY_LENGTH = 64;
+function scanOscReply(s, at) {
+  if (s.length < at + 3) return "none";
+  for (let k = 2; k < 5; k++) {
+    const ch = s[at + k];
+    if (ch === void 0) return "partial";
+    const ok = k === 2 ? ch === "1" : k === 3 ? ch === "0" || ch === "1" : ch === ";";
+    if (!ok) return "none";
+  }
+  for (let i = at + 5; i < s.length && i - at <= MAX_REPLY_LENGTH; i++) {
+    const ch = s[i] ?? "";
+    if (ch === "\x07") return i + 1;
+    if (ch === "\x1B") {
+      const next = s[i + 1];
+      if (next === void 0) return "partial";
+      return next === "\\" ? i + 2 : "none";
+    }
+    if (!/[0-9a-z:/]/i.test(ch)) return "none";
+  }
+  return s.length - at > MAX_REPLY_LENGTH ? "none" : "partial";
+}
+function scanDa1Reply(s, at) {
+  if (s[at + 2] !== "?") return "none";
+  for (let i = at + 3; i < s.length && i - at <= MAX_REPLY_LENGTH; i++) {
+    const ch = s[i] ?? "";
+    if (ch === "c") return i + 1;
+    if (!/[\d;]/.test(ch)) return "none";
+  }
+  return s.length - at > MAX_REPLY_LENGTH ? "none" : "partial";
+}
+function scanReply(s, at) {
+  const kind = s[at + 1];
+  if (kind === "]") return scanOscReply(s, at);
+  if (kind === "[") return scanDa1Reply(s, at);
+  return "none";
+}
+function stripReplies(input) {
+  let keys = "";
+  let i = 0;
+  while (i < input.length) {
+    const esc = input.indexOf("\x1B", i);
+    if (esc === -1) {
+      keys += input.slice(i);
+      break;
+    }
+    keys += input.slice(i, esc);
+    const end = scanReply(input, esc);
+    if (end === "partial") return { keys, held: input.slice(esc) };
+    if (end === "none") {
+      keys += "\x1B";
+      i = esc + 1;
+    } else {
+      i = end;
+    }
+  }
+  return { keys, held: "" };
+}
+function createTerminalReplyFilter() {
+  let held = "";
+  return (data) => {
+    const result = stripReplies(held + data);
+    held = result.held;
+    return result.keys;
+  };
+}
+async function detectBackgroundTheme(io) {
+  const caps = (0, import_caps.getCaps)();
+  if (!shouldQueryBackground(caps, io.stdin.isTTY === true)) return;
+  const theme = await queryBackgroundTheme(io, BACKGROUND_TIMEOUT_MS);
+  if (theme !== null && theme !== caps.theme) (0, import_caps.setCaps)({ ...(0, import_caps.getCaps)(), theme });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BACKGROUND_QUERY,
+  BACKGROUND_TIMEOUT_MS,
+  createTerminalReplyFilter,
+  detectBackgroundTheme,
+  parseBackgroundReply,
+  queryBackgroundTheme,
+  shouldQueryBackground
+});

package/dist/signal/background.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Asks the terminal for its background colour (OSC 11) so the Signal palette picks its dark or
+ * light set from what is actually on screen, not from COLORFGBG alone.
+ *
+ * The query is followed by DA1 (primary device attributes), which every terminal answers. That
+ * reply marks the end: a terminal that ignores OSC 11 costs one round trip, not the timeout.
+ * Runs once at start-up, before Ink takes stdin.
+ */
+import { type Caps, type ThemeName } from './caps.js';
+export declare const BACKGROUND_QUERY = "\u001B]11;?\u0007\u001B[c";
+/** How long to wait for a terminal that answers neither query (a pipe dressed as a TTY). */
+export declare const BACKGROUND_TIMEOUT_MS = 250;
+/** The theme for an OSC 11 reply found anywhere in `data`, or null when there is none. */
+export declare function parseBackgroundReply(data: string): ThemeName | null;
+/** Only the Signal palette reads the theme, and only a colour TTY can answer. */
+export declare function shouldQueryBackground(caps: Caps, stdinIsTTY: boolean): boolean;
+export interface TerminalIO {
+    stdin: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+        isRaw?: boolean;
+        setRawMode?: (mode: boolean) => unknown;
+    };
+    stdout: {
+        write: (chunk: string) => boolean;
+    };
+}
+/**
+ * Sends the query and resolves with the background's theme, or null when the terminal does not
+ * say. Everything read that is not a complete reply goes back onto stdin byte for byte: keys
+ * typed during start-up, a UTF-8 character cut off by the timeout, and the start of a reply cut
+ * off by it (the keypress filter drops the rest of that reply when it arrives). Leaves stdin
+ * paused and in the raw mode it found it in.
+ */
+export declare function queryBackgroundTheme(io: TerminalIO, timeoutMs: number): Promise<ThemeName | null>;
+/**
+ * Removes OSC 10/11 and DA1 replies from keyboard input, holding back the start of one that is
+ * split across chunks. Sits in front of the keypress parser so a reply that arrives after
+ * `queryBackgroundTheme` gave up never becomes prompt text. One filter per input stream.
+ */
+export declare function createTerminalReplyFilter(): (data: string) => string;
+/** Refines the process-wide caps' theme from the terminal's background, when it can tell. */
+export declare function detectBackgroundTheme(io: TerminalIO): Promise<void>;
+//# sourceMappingURL=background.d.ts.map

package/dist/signal/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/signal/background.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAoB,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAExE,eAAO,MAAM,gBAAgB,8BAAwB,CAAC;AAEtD,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAYzC,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMnE;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAE9E;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;KAC3C,CAAC;IACF,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,CAAC;CACjD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA0BjG;AA0ED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAOpE;AAED,6FAA6F;AAC7F,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE"}

package/dist/signal/background.js

@@ -0,0 +1,124 @@
+import { getCaps, setCaps } from "./caps.js";
+const BACKGROUND_QUERY = "\x1B]11;?\x07\x1B[c";
+const BACKGROUND_TIMEOUT_MS = 250;
+const OSC11_REPLY = /\x1b\]11;rgba?:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})/i;
+const DA1_REPLY = /\x1b\[\?[\d;]*c/;
+function channel(hex) {
+  return parseInt(hex, 16) / (16 ** hex.length - 1);
+}
+function parseBackgroundReply(data) {
+  const match = OSC11_REPLY.exec(data);
+  if (match === null) return null;
+  const [r, g, b] = [match[1], match[2], match[3]].map((hex) => channel(hex ?? ""));
+  if (r === void 0 || g === void 0 || b === void 0) return null;
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b >= 0.5 ? "light" : "dark";
+}
+function shouldQueryBackground(caps, stdinIsTTY) {
+  return caps.palette === "signal" && caps.color !== "none" && caps.tty && stdinIsTTY;
+}
+function queryBackgroundTheme(io, timeoutMs) {
+  const { stdin, stdout } = io;
+  const wasRaw = stdin.isRaw === true;
+  return new Promise((resolve) => {
+    let received = "";
+    const finish = () => {
+      clearTimeout(timer);
+      stdin.removeListener("data", onData);
+      stdin.setRawMode?.(wasRaw);
+      stdin.pause();
+      const { keys, held } = stripReplies(received);
+      const rest = keys + held;
+      if (rest !== "") stdin.unshift(Buffer.from(rest, "latin1"));
+      resolve(parseBackgroundReply(received));
+    };
+    const onData = (chunk) => {
+      received += (typeof chunk === "string" ? Buffer.from(chunk) : chunk).toString("latin1");
+      if (DA1_REPLY.test(received)) finish();
+    };
+    const timer = setTimeout(finish, timeoutMs);
+    stdin.setRawMode?.(true);
+    stdin.on("data", onData);
+    stdin.resume();
+    stdout.write(BACKGROUND_QUERY);
+  });
+}
+const MAX_REPLY_LENGTH = 64;
+function scanOscReply(s, at) {
+  if (s.length < at + 3) return "none";
+  for (let k = 2; k < 5; k++) {
+    const ch = s[at + k];
+    if (ch === void 0) return "partial";
+    const ok = k === 2 ? ch === "1" : k === 3 ? ch === "0" || ch === "1" : ch === ";";
+    if (!ok) return "none";
+  }
+  for (let i = at + 5; i < s.length && i - at <= MAX_REPLY_LENGTH; i++) {
+    const ch = s[i] ?? "";
+    if (ch === "\x07") return i + 1;
+    if (ch === "\x1B") {
+      const next = s[i + 1];
+      if (next === void 0) return "partial";
+      return next === "\\" ? i + 2 : "none";
+    }
+    if (!/[0-9a-z:/]/i.test(ch)) return "none";
+  }
+  return s.length - at > MAX_REPLY_LENGTH ? "none" : "partial";
+}
+function scanDa1Reply(s, at) {
+  if (s[at + 2] !== "?") return "none";
+  for (let i = at + 3; i < s.length && i - at <= MAX_REPLY_LENGTH; i++) {
+    const ch = s[i] ?? "";
+    if (ch === "c") return i + 1;
+    if (!/[\d;]/.test(ch)) return "none";
+  }
+  return s.length - at > MAX_REPLY_LENGTH ? "none" : "partial";
+}
+function scanReply(s, at) {
+  const kind = s[at + 1];
+  if (kind === "]") return scanOscReply(s, at);
+  if (kind === "[") return scanDa1Reply(s, at);
+  return "none";
+}
+function stripReplies(input) {
+  let keys = "";
+  let i = 0;
+  while (i < input.length) {
+    const esc = input.indexOf("\x1B", i);
+    if (esc === -1) {
+      keys += input.slice(i);
+      break;
+    }
+    keys += input.slice(i, esc);
+    const end = scanReply(input, esc);
+    if (end === "partial") return { keys, held: input.slice(esc) };
+    if (end === "none") {
+      keys += "\x1B";
+      i = esc + 1;
+    } else {
+      i = end;
+    }
+  }
+  return { keys, held: "" };
+}
+function createTerminalReplyFilter() {
+  let held = "";
+  return (data) => {
+    const result = stripReplies(held + data);
+    held = result.held;
+    return result.keys;
+  };
+}
+async function detectBackgroundTheme(io) {
+  const caps = getCaps();
+  if (!shouldQueryBackground(caps, io.stdin.isTTY === true)) return;
+  const theme = await queryBackgroundTheme(io, BACKGROUND_TIMEOUT_MS);
+  if (theme !== null && theme !== caps.theme) setCaps({ ...getCaps(), theme });
+}
+export {
+  BACKGROUND_QUERY,
+  BACKGROUND_TIMEOUT_MS,
+  createTerminalReplyFilter,
+  detectBackgroundTheme,
+  parseBackgroundReply,
+  queryBackgroundTheme,
+  shouldQueryBackground
+};