@probelabs/probe 0.6.0-rc294 → 0.6.0-rc296

package/README.md

@@ -140,6 +140,13 @@ export MODEL_NAME=claude-sonnet-4-6
 - **Session management** - Maintain conversation context across calls
 - **Token tracking** - Monitor usage and costs
 - **Configurable personas** - Engineer, architect, code-review, and more
+- **Smart timeout handling** - Three timeout modes (graceful, hard, negotiated) with two-phase graceful stop for delegates and MCP servers
+
+### Timeout Modes
+
+ProbeAgent supports three timeout behaviors (`graceful`, `hard`, `negotiated`) for controlling what happens when `maxOperationTimeout` is reached. The `negotiated` mode uses an independent observer LLM call that works even when the main loop is blocked by delegates. Delegates inherit timeout settings from the parent and are budget-aware — their timeout is capped to the parent's remaining budget. MCP servers that expose a `graceful_stop` tool get cooperative shutdown signals.
+
+See [Timeout Architecture](../docs/probe-agent/sdk/timeout-modes.md) for the full reference.
 
 ### Agent Skills (repo-local)
 

package/build/agent/ProbeAgent.d.ts

@@ -106,6 +106,16 @@ export interface ProbeAgentOptions {
   requestTimeout?: number;
   /** Maximum timeout in ms for the entire operation including all retries and fallbacks (default: 300000 or MAX_OPERATION_TIMEOUT env var). This is the absolute maximum time for streamTextWithRetryAndFallback. */
   maxOperationTimeout?: number;
+  /** Timeout behavior: 'graceful' winds down with bonus steps, 'hard' aborts immediately, 'negotiated' uses a timeout observer (separate LLM call) to decide extensions (default: 'graceful'). Env var: TIMEOUT_BEHAVIOR */
+  timeoutBehavior?: 'graceful' | 'hard' | 'negotiated';
+  /** Number of bonus steps during graceful timeout wind-down (default: 4, range: 1-20). Env var: GRACEFUL_TIMEOUT_BONUS_STEPS */
+  gracefulTimeoutBonusSteps?: number;
+  /** Total extra time budget in ms for negotiated timeout (default: 1800000 = 30 min). Env var: NEGOTIATED_TIMEOUT_BUDGET */
+  negotiatedTimeoutBudget?: number;
+  /** Max time extension requests for negotiated timeout (default: 3, range: 1-10). Env var: NEGOTIATED_TIMEOUT_MAX_REQUESTS */
+  negotiatedTimeoutMaxRequests?: number;
+  /** Max ms per extension request for negotiated timeout (default: 600000 = 10 min). Env var: NEGOTIATED_TIMEOUT_MAX_PER_REQUEST */
+  negotiatedTimeoutMaxPerRequest?: number;
 }
 
 /**