flavor-code 1.2.17 → 1.2.18

package/dist/{app-F4P7RV2X.js → app-YE3I7JMR.js}

@@ -14,8 +14,9 @@ import {
   modelContentTranscriptText,
   packageVersion,
   redactErrorText,
-  transcriptReducer
-} from "./chunk-QQCXJC4U.js";
+  transcriptReducer,
+  withTimeout
+} from "./chunk-STZQ3Y3P.js";
 import "./chunk-IG4Z23CL.js";
 import {
   Box_default,
@@ -874,21 +875,27 @@ function CodeBlock({ token }) {
   const langLabel = token.lang?.trim();
   const label = langLabel && langLabel.length > 0 ? langLabel : "code";
   const topBarWidth = Math.max(0, columns - 4 - label.length - 4);
-  return /* @__PURE__ */ jsxs(Box_default, { flexDirection: "column", paddingX: 1, children: [
-    /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
-      "\u256D\u2500 ",
-      /* @__PURE__ */ jsx(Text, { color: "cyan", children: label }),
-      " ",
-      "\u2500".repeat(topBarWidth),
-      "\u256E"
-    ] }),
-    /* @__PURE__ */ jsx(Box_default, { flexDirection: "column", paddingX: 1, children: truncated.map((line, i) => /* @__PURE__ */ jsx(Text, { color: "gray", children: line }, i)) }),
-    /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
-      "\u2570",
-      "\u2500".repeat(Math.max(0, columns - 6)),
-      "\u256F"
+  return (
+    // Code blocks are self-contained painted regions. Marking the region
+    // opaque prevents ScrollBox's incremental renderer from blitting cached
+    // blank cells over clean, single-line code bodies during transcript
+    // scrolls/redraws.
+    /* @__PURE__ */ jsxs(Box_default, { flexDirection: "column", paddingX: 1, opaque: true, children: [
+      /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+        "\u256D\u2500 ",
+        /* @__PURE__ */ jsx(Text, { color: "cyan", children: label }),
+        " ",
+        "\u2500".repeat(topBarWidth),
+        "\u256E"
+      ] }),
+      /* @__PURE__ */ jsx(Box_default, { flexDirection: "column", paddingX: 1, children: truncated.map((line, i) => /* @__PURE__ */ jsx(Text, { color: "gray", children: line }, i)) }),
+      /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+        "\u2570",
+        "\u2500".repeat(Math.max(0, columns - 6)),
+        "\u256F"
+      ] })
     ] })
-  ] });
+  );
 }
 function BlockquoteView({ token }) {
   return /* @__PURE__ */ jsx(Box_default, { flexDirection: "column", children: token.tokens.map((child, i) => {
@@ -1098,9 +1105,15 @@ function AssistantTextInner({ text }) {
 var AssistantText = React2.memo(AssistantTextInner);
 
 // src/ui/signals.ts
-function createSessionInterruptHandler(getSession, shutdown) {
+function createSessionInterruptHandler(getSession, shutdown, options) {
+  let shuttingDown = false;
   return () => {
+    if (shuttingDown) {
+      options.forceExit();
+      return;
+    }
     if (getSession()?.interrupt() === "cancelled") return;
+    shuttingDown = true;
     void shutdown();
   };
 }
@@ -1901,7 +1914,8 @@ function App({ workspace, home, resumeSession, instanceId, palAlias }) {
   const interruptRef = useRef4(void 0);
   interruptRef.current ??= createSessionInterruptHandler(
     () => runtimeRef.current?.session,
-    () => shutdownRef.current(runtimeRef.current)
+    () => shutdownRef.current(runtimeRef.current),
+    { forceExit: () => process.exit(1) }
   );
   const interrupt = interruptRef.current;
   useEffect3(() => {
@@ -3529,11 +3543,23 @@ async function submitSafely(session, prompt, report) {
     safeReport(report, safeUiError(error));
   }
 }
-async function shutdownRuntime(runtime, exit, report) {
+var SHUTDOWN_TIMEOUT_MS = 8e3;
+var FORCE_EXIT_GRACE_MS = 250;
+async function shutdownRuntime(runtime, exit, report, options = {}) {
+  const timeoutMs = options.shutdownTimeoutMs ?? SHUTDOWN_TIMEOUT_MS;
+  let timedOut = false;
   try {
-    await closeAndDisposeRuntime(runtime, report);
+    const outcome = await withTimeout(closeAndDisposeRuntime(runtime, report), timeoutMs);
+    timedOut = outcome.timedOut;
+    if (timedOut) report(`Shutdown timed out after ${timeoutMs}ms; forcing exit.`);
   } finally {
     exit();
+    if (timedOut) {
+      const forceExit = options.forceExit ?? (() => {
+        process.exit(1);
+      });
+      setTimeout(forceExit, FORCE_EXIT_GRACE_MS);
+    }
   }
 }
 async function closeAndDisposeRuntime(runtime, report) {
@@ -3565,6 +3591,7 @@ export {
   HISTORY_CAP,
   MentionMenu,
   PromptLine,
+  SHUTDOWN_TIMEOUT_MS,
   SinglePendingPrompt,
   TerminalLayout,
   appRuntimeOptions,

package/dist/{chunk-YRIPE5K5.js → chunk-JB57IX2A.js}

@@ -4,7 +4,7 @@ import {
   message,
   redactErrorText,
   redactSecrets
-} from "./chunk-QQCXJC4U.js";
+} from "./chunk-STZQ3Y3P.js";
 
 // src/rpc/server.ts
 import { createInterface } from "readline";

package/dist/{chunk-QQCXJC4U.js → chunk-STZQ3Y3P.js}

@@ -62,6 +62,52 @@ function normalizeProviderError(error) {
   return { code, message: message2 };
 }
 
+// src/utils/async.ts
+function withTimeout(promise, ms) {
+  return new Promise((resolve26, reject) => {
+    let settled = false;
+    const timer = setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      resolve26({ timedOut: true, value: void 0 });
+    }, ms);
+    timer.unref?.();
+    promise.then(
+      (value) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timer);
+          resolve26({ timedOut: false, value });
+        }
+      },
+      (error) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timer);
+          reject(error);
+        }
+      }
+    );
+  });
+}
+function awaitWithSignal(promise, signal) {
+  signal.throwIfAborted();
+  return new Promise((resolve26, reject) => {
+    const onAbort = () => reject(signal.reason);
+    signal.addEventListener("abort", onAbort, { once: true });
+    promise.then(
+      (value) => {
+        signal.removeEventListener("abort", onAbort);
+        resolve26(value);
+      },
+      (error) => {
+        signal.removeEventListener("abort", onAbort);
+        reject(error);
+      }
+    );
+  });
+}
+
 // src/utils/error.ts
 function message(error) {
   return error instanceof Error ? error.message : String(error);
@@ -5058,25 +5104,6 @@ function hasCycle(nodes) {
   return visited !== nodes.length;
 }
 
-// src/utils/async.ts
-function awaitWithSignal(promise, signal) {
-  signal.throwIfAborted();
-  return new Promise((resolve26, reject) => {
-    const onAbort = () => reject(signal.reason);
-    signal.addEventListener("abort", onAbort, { once: true });
-    promise.then(
-      (value) => {
-        signal.removeEventListener("abort", onAbort);
-        resolve26(value);
-      },
-      (error) => {
-        signal.removeEventListener("abort", onAbort);
-        reject(error);
-      }
-    );
-  });
-}
-
 // src/agent/subagents.ts
 var SubagentResultSchema = z5.object({
   taskId: z5.string().min(1),
@@ -18993,6 +19020,7 @@ var INTERRUPTED_TASK_PLAN_CONTEXT = [
   "Reassess the current query independently.",
   "If the current work needs a plan, create a fresh one with TaskPlan before using TaskUpdate."
 ].join(" ");
+var DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS = 3e3;
 function createPromptEnvironment(input = {}) {
   const now = input.now ?? /* @__PURE__ */ new Date();
   return {
@@ -20561,23 +20589,24 @@ ${renderMemoryDocument(entries)}`;
       async dispose() {
         if (disposed) return;
         disposed = true;
+        const stepTimeoutMs = options.shutdownStepTimeoutMs ?? DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS;
         collaborationEventsOpen = false;
         unsubscribeCollaboration?.();
-        await collaborationEventPump;
+        if (collaborationEventPump !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-event-pump", collaborationEventPump);
         mcpDiscarded = true;
-        await sleepScheduler?.dispose();
-        await memoryCoordinator?.flush();
-        await persist();
-        await persistTail;
-        if (ideSessionId !== void 0) await ide.endSession(ideSessionId);
-        await executionEnvironment?.dispose();
+        if (sleepScheduler !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "sleep-scheduler", sleepScheduler.dispose());
+        if (memoryCoordinator !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "memory-flush", memoryCoordinator.flush());
+        await boundedStep(stepTimeoutMs, diagnostics, "persist", persist());
+        if (persistTail !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "persist-tail", persistTail);
+        if (ideSessionId !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "ide-end-session", ide.endSession(ideSessionId));
+        if (executionEnvironment !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "execution-environment", executionEnvironment.dispose());
         terminals.dispose();
-        await jobs.dispose();
+        await boundedStep(stepTimeoutMs, diagnostics, "jobs", jobs.dispose());
         auditLogger.close();
         evolveService.dispose();
         memoryReviews.dispose();
-        await collaborationClient?.close();
-        await cleanupProduction(approvals, questions, pluginHost, mcpManager, harness);
+        if (collaborationClient !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-close", collaborationClient.close());
+        await cleanupProduction(approvals, questions, pluginHost, mcpManager, harness, { stepTimeoutMs });
       }
     };
   } catch (primaryError) {
@@ -20585,16 +20614,17 @@ ${renderMemoryDocument(entries)}`;
     mcpDiscarded = true;
     memoryReviews.dispose();
     try {
-      if (ideSessionId !== void 0) await ide.endSession(ideSessionId);
-      await sleepScheduler?.dispose();
-      await executionEnvironment?.dispose();
+      const stepTimeoutMs = options.shutdownStepTimeoutMs ?? DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS;
+      if (ideSessionId !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "ide-end-session", ide.endSession(ideSessionId));
+      if (sleepScheduler !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "sleep-scheduler", sleepScheduler.dispose());
+      if (executionEnvironment !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "execution-environment", executionEnvironment.dispose());
       terminals.dispose();
-      await jobs.dispose();
+      await boundedStep(stepTimeoutMs, diagnostics, "jobs", jobs.dispose());
       unsubscribeCollaboration?.();
       pendingCollaborationEvents.length = 0;
-      await collaborationEventPump;
-      await collaborationClient?.close();
-      await cleanupProduction(approvals, questions, pluginHost, mcpManager, harnessCreated ? harness : void 0);
+      if (collaborationEventPump !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-event-pump", collaborationEventPump);
+      if (collaborationClient !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-close", collaborationClient.close());
+      await cleanupProduction(approvals, questions, pluginHost, mcpManager, harnessCreated ? harness : void 0, { stepTimeoutMs });
     } catch (cleanupError) {
       attachCleanupError(primaryError, cleanupError);
     }
@@ -21215,7 +21245,8 @@ function storedConversation(snapshot4) {
     })
   };
 }
-async function cleanupProduction(approvals, questions, pluginHost, mcpManager, harness) {
+async function cleanupProduction(approvals, questions, pluginHost, mcpManager, harness, cleanupOptions = { stepTimeoutMs: DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS }) {
+  const { stepTimeoutMs } = cleanupOptions;
   let primary;
   try {
     approvals.resolve("deny");
@@ -21229,7 +21260,8 @@ async function cleanupProduction(approvals, questions, pluginHost, mcpManager, h
     else attachCleanupError(primary, error);
   }
   try {
-    await pluginHost.unloadAll();
+    const outcome = await withTimeout(pluginHost.unloadAll(), stepTimeoutMs);
+    if (outcome.timedOut) primary = new Error(`Plugin unload timed out after ${stepTimeoutMs}ms`);
   } catch (error) {
     if (primary === void 0) primary = error;
     else attachCleanupError(primary, error);
@@ -21241,7 +21273,14 @@ async function cleanupProduction(approvals, questions, pluginHost, mcpManager, h
       else attachCleanupError(primary, error);
     }
     try {
-      await mcpManager?.close();
+      if (mcpManager !== void 0) {
+        const outcome = await withTimeout(mcpManager.close(), stepTimeoutMs);
+        if (outcome.timedOut) {
+          const timeoutError = new Error(`MCP shutdown timed out after ${stepTimeoutMs}ms`);
+          if (primary === void 0) primary = timeoutError;
+          else attachCleanupError(primary, timeoutError);
+        }
+      }
     } catch (error) {
       if (primary === void 0) primary = error;
       else attachCleanupError(primary, error);
@@ -21249,6 +21288,10 @@ async function cleanupProduction(approvals, questions, pluginHost, mcpManager, h
   }
   if (primary !== void 0) throw primary;
 }
+async function boundedStep(timeoutMs, diagnostics, name, step) {
+  const outcome = await withTimeout(step, timeoutMs);
+  if (outcome.timedOut) diagnostics.push(`Shutdown step "${name}" timed out after ${timeoutMs}ms and was abandoned.`);
+}
 function attachCleanupError(primary, cleanup) {
   if (typeof primary !== "object" && typeof primary !== "function" || primary === null || !Object.isExtensible(primary)) return;
   try {
@@ -21334,6 +21377,7 @@ function createMemoryTaskId() {
 
 export {
   modelContentTranscriptText,
+  withTimeout,
   message,
   isDestructiveTool,
   redactErrorText,

package/dist/cli.js

@@ -3,7 +3,7 @@ import { createRequire } from "node:module"; const require = createRequire(impor
 import {
   FlavorRpcServer,
   TraceRecorder
-} from "./chunk-YRIPE5K5.js";
+} from "./chunk-JB57IX2A.js";
 import {
   staticTaskLines
 } from "./chunk-KKIBYDJI.js";
@@ -22,7 +22,7 @@ import {
   packageVersion,
   redactErrorText,
   runPalBroker
-} from "./chunk-QQCXJC4U.js";
+} from "./chunk-STZQ3Y3P.js";
 import {
   McpServerConfigSchema,
   McpServerNameSchema,
@@ -861,7 +861,7 @@ async function runInteractiveCli(props) {
   const [{ render, AlternateScreen }, { createElement }, { App }] = await Promise.all([
     import("./claude-ink-ORUA7GWG.js"),
     import("react"),
-    import("./app-F4P7RV2X.js")
+    import("./app-YE3I7JMR.js")
   ]);
   const instance = await render(createElement(
     AlternateScreen,

package/dist/desktop/main.js

@@ -4348,6 +4348,33 @@ function hasCycle(nodes) {
 }
 
 // src/utils/async.ts
+function withTimeout(promise, ms) {
+  return new Promise((resolve34, reject) => {
+    let settled = false;
+    const timer = setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      resolve34({ timedOut: true, value: void 0 });
+    }, ms);
+    timer.unref?.();
+    promise.then(
+      (value) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timer);
+          resolve34({ timedOut: false, value });
+        }
+      },
+      (error) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timer);
+          reject(error);
+        }
+      }
+    );
+  });
+}
 function awaitWithSignal3(promise, signal) {
   signal.throwIfAborted();
   return new Promise((resolve34, reject) => {
@@ -22696,6 +22723,7 @@ var INTERRUPTED_TASK_PLAN_CONTEXT = [
   "Reassess the current query independently.",
   "If the current work needs a plan, create a fresh one with TaskPlan before using TaskUpdate."
 ].join(" ");
+var DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS = 3e3;
 function createPromptEnvironment(input = {}) {
   const now = input.now ?? /* @__PURE__ */ new Date();
   return {
@@ -24264,23 +24292,24 @@ ${renderMemoryDocument(entries)}`;
       async dispose() {
         if (disposed) return;
         disposed = true;
+        const stepTimeoutMs = options.shutdownStepTimeoutMs ?? DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS;
         collaborationEventsOpen = false;
         unsubscribeCollaboration?.();
-        await collaborationEventPump;
+        if (collaborationEventPump !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-event-pump", collaborationEventPump);
         mcpDiscarded = true;
-        await sleepScheduler?.dispose();
-        await memoryCoordinator?.flush();
-        await persist();
-        await persistTail;
-        if (ideSessionId !== void 0) await ide.endSession(ideSessionId);
-        await executionEnvironment?.dispose();
+        if (sleepScheduler !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "sleep-scheduler", sleepScheduler.dispose());
+        if (memoryCoordinator !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "memory-flush", memoryCoordinator.flush());
+        await boundedStep(stepTimeoutMs, diagnostics, "persist", persist());
+        if (persistTail !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "persist-tail", persistTail);
+        if (ideSessionId !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "ide-end-session", ide.endSession(ideSessionId));
+        if (executionEnvironment !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "execution-environment", executionEnvironment.dispose());
         terminals.dispose();
-        await jobs.dispose();
+        await boundedStep(stepTimeoutMs, diagnostics, "jobs", jobs.dispose());
         auditLogger.close();
         evolveService.dispose();
         memoryReviews.dispose();
-        await collaborationClient?.close();
-        await cleanupProduction(approvals, questions, pluginHost, mcpManager, harness);
+        if (collaborationClient !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-close", collaborationClient.close());
+        await cleanupProduction(approvals, questions, pluginHost, mcpManager, harness, { stepTimeoutMs });
       }
     };
   } catch (primaryError) {
@@ -24288,16 +24317,17 @@ ${renderMemoryDocument(entries)}`;
     mcpDiscarded = true;
     memoryReviews.dispose();
     try {
-      if (ideSessionId !== void 0) await ide.endSession(ideSessionId);
-      await sleepScheduler?.dispose();
-      await executionEnvironment?.dispose();
+      const stepTimeoutMs = options.shutdownStepTimeoutMs ?? DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS;
+      if (ideSessionId !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "ide-end-session", ide.endSession(ideSessionId));
+      if (sleepScheduler !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "sleep-scheduler", sleepScheduler.dispose());
+      if (executionEnvironment !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "execution-environment", executionEnvironment.dispose());
       terminals.dispose();
-      await jobs.dispose();
+      await boundedStep(stepTimeoutMs, diagnostics, "jobs", jobs.dispose());
       unsubscribeCollaboration?.();
       pendingCollaborationEvents.length = 0;
-      await collaborationEventPump;
-      await collaborationClient?.close();
-      await cleanupProduction(approvals, questions, pluginHost, mcpManager, harnessCreated ? harness : void 0);
+      if (collaborationEventPump !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-event-pump", collaborationEventPump);
+      if (collaborationClient !== void 0) await boundedStep(stepTimeoutMs, diagnostics, "collaboration-close", collaborationClient.close());
+      await cleanupProduction(approvals, questions, pluginHost, mcpManager, harnessCreated ? harness : void 0, { stepTimeoutMs });
     } catch (cleanupError) {
       attachCleanupError(primaryError, cleanupError);
     }
@@ -24918,7 +24948,8 @@ function storedConversation(snapshot4) {
     })
   };
 }
-async function cleanupProduction(approvals, questions, pluginHost, mcpManager, harness) {
+async function cleanupProduction(approvals, questions, pluginHost, mcpManager, harness, cleanupOptions = { stepTimeoutMs: DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS }) {
+  const { stepTimeoutMs } = cleanupOptions;
   let primary;
   try {
     approvals.resolve("deny");
@@ -24932,7 +24963,8 @@ async function cleanupProduction(approvals, questions, pluginHost, mcpManager, h
     else attachCleanupError(primary, error);
   }
   try {
-    await pluginHost.unloadAll();
+    const outcome = await withTimeout(pluginHost.unloadAll(), stepTimeoutMs);
+    if (outcome.timedOut) primary = new Error(`Plugin unload timed out after ${stepTimeoutMs}ms`);
   } catch (error) {
     if (primary === void 0) primary = error;
     else attachCleanupError(primary, error);
@@ -24944,7 +24976,14 @@ async function cleanupProduction(approvals, questions, pluginHost, mcpManager, h
       else attachCleanupError(primary, error);
     }
     try {
-      await mcpManager?.close();
+      if (mcpManager !== void 0) {
+        const outcome = await withTimeout(mcpManager.close(), stepTimeoutMs);
+        if (outcome.timedOut) {
+          const timeoutError = new Error(`MCP shutdown timed out after ${stepTimeoutMs}ms`);
+          if (primary === void 0) primary = timeoutError;
+          else attachCleanupError(primary, timeoutError);
+        }
+      }
     } catch (error) {
       if (primary === void 0) primary = error;
       else attachCleanupError(primary, error);
@@ -24952,6 +24991,10 @@ async function cleanupProduction(approvals, questions, pluginHost, mcpManager, h
   }
   if (primary !== void 0) throw primary;
 }
+async function boundedStep(timeoutMs, diagnostics, name, step) {
+  const outcome = await withTimeout(step, timeoutMs);
+  if (outcome.timedOut) diagnostics.push(`Shutdown step "${name}" timed out after ${timeoutMs}ms and was abandoned.`);
+}
 function attachCleanupError(primary, cleanup) {
   if (typeof primary !== "object" && typeof primary !== "function" || primary === null || !Object.isExtensible(primary)) return;
   try {

package/dist/production.d.ts

@@ -11,6 +11,12 @@ import { type TranscriptState } from "./ui/transcript.js";
 import { MemoryReviewBridge } from "./memory/review.js";
 import { type JobSnapshot } from "./jobs/registry.js";
 import { type PalClientLike } from "./pals/tools.js";
+/**
+ * Per-step shutdown budget. On Windows a hung child-process pipe, named pipe,
+ * or MCP stdio server can block one cleanup step forever; abandoning that step
+ * after the budget lets the remaining steps — and process exit — proceed.
+ */
+export declare const DEFAULT_SHUTDOWN_STEP_TIMEOUT_MS = 3000;
 export interface ProductionRuntimeOptions {
     workspace?: string;
     home?: string;
@@ -27,6 +33,8 @@ export interface ProductionRuntimeOptions {
     resumeSession?: string | true;
     /** Test and embedding seam for creating configured MCP clients. */
     mcpClientFactory?: McpClientFactory;
+    /** Per-step timeout (ms) for shutdown/disposal steps so a hung cleanup cannot block process exit. */
+    shutdownStepTimeoutMs?: number;
     /** Additional tools provided by embedders (e.g. desktop-only D2C tools). */
     extraTools?: readonly ToolDefinition<unknown>[];
     /** Explicitly opt into CLI-local collaboration. Omit for print/RPC/eval callers. */

package/dist/sdk/index.js

@@ -4,7 +4,7 @@ import {
   FlavorRpcServer,
   TraceRecordSchema,
   TraceRecorder
-} from "../chunk-YRIPE5K5.js";
+} from "../chunk-JB57IX2A.js";
 import {
   AgentMessageQueue,
   DockerExecutionEnvironment,
@@ -13,7 +13,7 @@ import {
   WorkspaceCheckpointStore,
   buildDockerInvocation,
   createProductionRuntime
-} from "../chunk-QQCXJC4U.js";
+} from "../chunk-STZQ3Y3P.js";
 import "../chunk-IG4Z23CL.js";
 import "../chunk-RQTYHUMK.js";
 import "../chunk-S32JRDZK.js";

package/dist/utils/async.d.ts

@@ -1,3 +1,17 @@
+export interface TimeoutOutcome<T> {
+    /** True when the deadline passed before the promise settled. */
+    timedOut: boolean;
+    /** The promise value; undefined when timed out (or when the value itself is undefined). */
+    value: T | undefined;
+}
+/**
+ * Race a promise against a deadline. Settles like the promise when it finishes
+ * in time; when the deadline passes first it resolves with `{ timedOut: true }`.
+ * The timer is always cleared so it never keeps the event loop alive on its own.
+ * The underlying promise is NOT cancelled — it keeps running in the background —
+ * so only use this for work you are willing to abandon (e.g. shutdown cleanup).
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<TimeoutOutcome<T>>;
 /**
  * Race a promise against an AbortSignal. If the signal fires before the
  * promise settles the returned promise rejects with the signal's reason.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flavor-code",
-  "version": "1.2.17",
+  "version": "1.2.18",
   "author": "YachuanWzh",
   "type": "module",
   "publishConfig": {