@opencow-ai/opencow-agent-sdk 0.4.27 → 0.4.28

package/dist/cli.mjs

@@ -86726,7 +86726,7 @@ function printStartupScreen() {
   const sLen = ` ● ${sL}    Ready — type /help to begin`.length;
   out.push(boxRow(sRow, W, sLen));
   out.push(`${rgb(...BORDER)}╚${"═".repeat(W - 2)}╝${RESET}`);
-  out.push(`  ${DIM}${rgb(...DIMCOL)}opencow ${RESET}${rgb(...ACCENT)}v${"0.4.27"}${RESET}`);
+  out.push(`  ${DIM}${rgb(...DIMCOL)}opencow ${RESET}${rgb(...ACCENT)}v${"0.4.28"}${RESET}`);
   out.push("");
   process.stdout.write(out.join(`
 `) + `
@@ -105105,6 +105105,10 @@ function tokenCountWithEstimation(messages) {
       }
       return getTokenCountFromUsage(usage) + roughTokenCountEstimationForMessages(messages.slice(i + 1));
     }
+    const baselineTokens = message?.contextBaselineTokens;
+    if (typeof baselineTokens === "number" && Number.isFinite(baselineTokens) && baselineTokens >= 0) {
+      return baselineTokens + roughTokenCountEstimationForMessages(messages.slice(i + 1));
+    }
     i--;
   }
   return roughTokenCountEstimationForMessages(messages);
@@ -138830,6 +138834,9 @@ function wrapBodyTransportError(error) {
   return new APIConnectionError({ message: error.message, cause: error });
 }
 function toReplayableStreamError(error) {
+  if (error instanceof EmptyStreamError) {
+    return new APIConnectionError({ message: error.message, cause: error });
+  }
   const wrapped = error instanceof Error && error.message.startsWith(STREAM_WATCHDOG_ABORT_PREFIX) ? new APIConnectionError({ message: error.message, cause: error }) : wrapBodyTransportError(error);
   if (!(wrapped instanceof APIConnectionError) || wrapped instanceof APIConnectionTimeoutError || extractConnectionErrorDetails(wrapped)?.isSSLError) {
     return null;
@@ -139288,7 +139295,7 @@ function getRateLimitResetDelayMs(error) {
   }
   return null;
 }
-var abortError = () => new APIUserAbortError, DEFAULT_MAX_RETRIES = 10, FLOOR_OUTPUT_TOKENS = 3000, MAX_529_RETRIES = 3, BASE_DELAY_MS = 500, FOREGROUND_529_RETRY_SOURCES, CONNECTION_WAIT_INITIAL_DELAY_MS = 5000, CONNECTION_WAIT_MAX_DELAY_MS = 60000, BODY_TRANSPORT_FAILURE_RE, STREAM_WATCHDOG_ABORT_PREFIX = "Stream idle timeout", PERSISTENT_MAX_BACKOFF_MS, PERSISTENT_RESET_CAP_MS, HEARTBEAT_INTERVAL_MS = 30000, DEFAULT_CONNECTION_WAIT_BACKOFF, CannotRetryError, FallbackTriggeredError, DEFAULT_FAST_MODE_FALLBACK_HOLD_MS, SHORT_RETRY_THRESHOLD_MS, MIN_COOLDOWN_MS;
+var abortError = () => new APIUserAbortError, DEFAULT_MAX_RETRIES = 10, FLOOR_OUTPUT_TOKENS = 3000, MAX_529_RETRIES = 3, BASE_DELAY_MS = 500, FOREGROUND_529_RETRY_SOURCES, CONNECTION_WAIT_INITIAL_DELAY_MS = 5000, CONNECTION_WAIT_MAX_DELAY_MS = 60000, BODY_TRANSPORT_FAILURE_RE, STREAM_WATCHDOG_ABORT_PREFIX = "Stream idle timeout", EmptyStreamError, PERSISTENT_MAX_BACKOFF_MS, PERSISTENT_RESET_CAP_MS, HEARTBEAT_INTERVAL_MS = 30000, DEFAULT_CONNECTION_WAIT_BACKOFF, CannotRetryError, FallbackTriggeredError, DEFAULT_FAST_MODE_FALLBACK_HOLD_MS, SHORT_RETRY_THRESHOLD_MS, MIN_COOLDOWN_MS;
 var init_retry = __esm(() => {
   init_sdk();
   init_aws();
@@ -139325,6 +139332,12 @@ var init_retry = __esm(() => {
     ...[]
   ]);
   BODY_TRANSPORT_FAILURE_RE = /socket connection was closed|^terminated$|other side closed|fetch failed/i;
+  EmptyStreamError = class EmptyStreamError extends Error {
+    constructor(message = "Stream ended before completing the response") {
+      super(message);
+      this.name = "EmptyStreamError";
+    }
+  };
   PERSISTENT_MAX_BACKOFF_MS = 5 * 60 * 1000;
   PERSISTENT_RESET_CAP_MS = 6 * 60 * 60 * 1000;
   DEFAULT_CONNECTION_WAIT_BACKOFF = {
@@ -235159,7 +235172,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-10-20T14:00:47.620Z").getTime();
+  const buildTime = new Date("2026-10-24T12:55:52.344Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -242982,6 +242995,11 @@ var init_coreSchemas = __esm(() => {
       trigger: _enum(["manual", "auto"]),
       pre_tokens: number2(),
       post_tokens: number2().optional().describe("Estimated resulting context size after compaction."),
+      context_snapshot: object({
+        schemaVersion: literal(1),
+        messages: array(unknown()),
+        baselineTokens: number2()
+      }).optional().describe("Opaque canonical post-compact context. Hosts persist and return it unchanged via Options.initialContextSnapshot."),
       preserved_segment: object({
         head_uuid: UUIDPlaceholder(),
         anchor_uuid: UUIDPlaceholder(),
@@ -291920,6 +291938,41 @@ var init_contextAnalysis = __esm(() => {
   init_slowOperations();
 });
 
+// src/session/contextSnapshot.ts
+function cloneSnapshotMessage(message) {
+  if (message.type !== "system" || message.subtype !== "compact_boundary") {
+    return message;
+  }
+  const { contextSnapshot: _ignored, ...compactMetadata } = message.compactMetadata;
+  return {
+    ...message,
+    compactMetadata
+  };
+}
+function isSnapshotMessage(message) {
+  return CONTEXT_SNAPSHOT_MESSAGE_TYPES.has(message.type);
+}
+function buildContextSnapshot(messages) {
+  const snapshotMessages = messages.filter(isSnapshotMessage).map(cloneSnapshotMessage);
+  if (snapshotMessages.length === 0)
+    return;
+  return {
+    schemaVersion: 1,
+    messages: snapshotMessages,
+    baselineTokens: tokenCountWithEstimation(snapshotMessages)
+  };
+}
+var CONTEXT_SNAPSHOT_MESSAGE_TYPES;
+var init_contextSnapshot = __esm(() => {
+  init_tokens();
+  CONTEXT_SNAPSHOT_MESSAGE_TYPES = new Set([
+    "assistant",
+    "user",
+    "attachment",
+    "system"
+  ]);
+});
+
 // src/session/memory/memdir/types.ts
 var MEMORY_TYPE_VALUES;
 var init_types10 = __esm(() => {
@@ -292501,6 +292554,15 @@ function buildPostCompactMessages(result) {
     ...result.hookResults
   ];
 }
+function attachContextSnapshot(result) {
+  if (!result.boundaryMarker?.compactMetadata)
+    return result;
+  const snapshot = buildContextSnapshot(buildPostCompactMessages(result));
+  if (snapshot) {
+    result.boundaryMarker.compactMetadata.contextSnapshot = snapshot;
+  }
+  return result;
+}
 function annotateBoundaryWithPreservedSegment(boundary, anchorUuid, messagesToKeep) {
   const keep = messagesToKeep ?? [];
   if (keep.length === 0)
@@ -293274,6 +293336,7 @@ var init_compact = __esm(() => {
   init_debug();
   init_errors2();
   init_fileStateCache();
+  init_contextSnapshot();
   init_forkedAgent();
   init_hooks2();
   init_log3();
@@ -294054,7 +294117,7 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
     markPostCompaction2();
     return {
       wasCompacted: true,
-      compactionResult: sessionMemoryResult
+      compactionResult: attachContextSnapshot(sessionMemoryResult)
     };
   }
   try {
@@ -294063,7 +294126,7 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
     runPostCompactCleanup(querySource);
     return {
       wasCompacted: true,
-      compactionResult,
+      compactionResult: attachContextSnapshot(compactionResult),
       consecutiveFailures: 0
     };
   } catch (error) {
@@ -294088,13 +294151,19 @@ async function manualCompact(messages, toolUseContext, cacheSafeParams, instruct
       setLastSummarizedMessageId(undefined);
       runPostCompactCleanup();
       markPostCompaction2();
-      return { wasCompacted: true, compactionResult: sessionMemoryResult };
+      return {
+        wasCompacted: true,
+        compactionResult: attachContextSnapshot(sessionMemoryResult)
+      };
     }
   }
   const compactionResult = await deps.compactConversation(messages, toolUseContext, cacheSafeParams, false, instructions, false);
   setLastSummarizedMessageId(undefined);
   runPostCompactCleanup();
-  return { wasCompacted: true, compactionResult };
+  return {
+    wasCompacted: true,
+    compactionResult: attachContextSnapshot(compactionResult)
+  };
 }
 var MAX_OUTPUT_TOKENS_FOR_SUMMARY = 20000, AUTOCOMPACT_BUFFER_TOKENS = 13000, WARNING_THRESHOLD_BUFFER_TOKENS = 20000, ERROR_THRESHOLD_BUFFER_TOKENS = 20000, MANUAL_COMPACT_BUFFER_TOKENS = 3000, MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES = 3;
 var init_autoCompact = __esm(() => {
@@ -297985,12 +298054,15 @@ ${deferredToolList}
         throw new Error("Stream idle timeout - no chunks received");
       }
       if (!partialMessage || newMessages.length === 0 && !stopReason) {
-        logForDebugging2(!partialMessage ? "Stream completed without receiving message_start event - triggering non-streaming fallback" : "Stream completed with message_start but no content blocks completed - triggering non-streaming fallback", { level: "error" });
+        logForDebugging2(!partialMessage ? "Stream completed without receiving message_start event - triggering non-streaming fallback" : "Stream completed with message_start but no content blocks completed - incomplete stream", { level: "error" });
         logEvent("tengu_stream_no_events", {
           model: options.model,
           request_id: streamRequestId ?? "unknown"
         });
-        throw new Error("Stream ended without receiving any events");
+        if (!partialMessage) {
+          throw new Error("Stream ended without receiving any events");
+        }
+        throw new EmptyStreamError;
       }
       if (stallCount > 0) {
         logForDebugging2(`Streaming completed with ${stallCount} stall(s), total stall time: ${(totalStallTime / 1000).toFixed(1)}s`, { level: "warn" });
@@ -298035,6 +298107,9 @@ ${deferredToolList}
           throw new APIConnectionTimeoutError({ message: "Request timed out" });
         }
       }
+      if (options.streamReplayEscape && newMessages.length === 0 && !signal.aborted && toReplayableStreamError(streamingError)) {
+        throw streamingError;
+      }
       const disableFallback = isEnvTruthy(resolveEnvVar("DISABLE_NONSTREAMING_FALLBACK")) || getFeatureValue_CACHED_MAY_BE_STALE("tengu_disable_streaming_to_non_streaming_fallback", false);
       if (disableFallback) {
         logForDebugging2(`Error streaming (non-streaming fallback disabled): ${errorMessage(streamingError)}`, { level: "error" });
@@ -435130,10 +435205,10 @@ var init_fuse = __esm(() => {
 });
 
 // missing-module-stub:/home/runner/work/opencow-agent-sdk/opencow-agent-sdk/src/cli/suggestions/skillUsageTracking.js
-var noop17 = () => null, recordSkillUsage2, getSkillUsageScore;
+var noop17 = () => null, getSkillUsageScore, recordSkillUsage2;
 var init_skillUsageTracking2 = __esm(() => {
-  recordSkillUsage2 = noop17;
   getSkillUsageScore = noop17;
+  recordSkillUsage2 = noop17;
 });
 
 // src/cli/suggestions/commandSuggestions.ts
@@ -445826,6 +445901,9 @@ function toSDKCompactMetadata(meta) {
     trigger: meta.trigger,
     pre_tokens: meta.preTokens,
     ...meta.postTokens !== undefined && { post_tokens: meta.postTokens },
+    ...meta.contextSnapshot !== undefined && {
+      context_snapshot: meta.contextSnapshot
+    },
     ...seg && {
       preserved_segment: {
         head_uuid: seg.headUuid,
@@ -445841,6 +445919,9 @@ function fromSDKCompactMetadata(meta) {
     trigger: meta.trigger,
     preTokens: meta.pre_tokens,
     ...meta.post_tokens !== undefined && { postTokens: meta.post_tokens },
+    ...meta.context_snapshot !== undefined && {
+      contextSnapshot: meta.context_snapshot
+    },
     ...seg && {
       preservedSegment: {
         headUuid: seg.head_uuid,
@@ -480124,7 +480205,7 @@ function buildPrimarySection() {
   }, undefined, false, undefined, this);
   return [{
     label: "Version",
-    value: "0.4.27"
+    value: "0.4.28"
   }, {
     label: "Session name",
     value: nameValue
@@ -528204,7 +528285,7 @@ var init_bridge_kick = __esm(() => {
 var call58 = async () => {
   return {
     type: "text",
-    value: `${"99.0.0"} (built ${"2026-10-20T14:00:47.620Z"})`
+    value: `${"99.0.0"} (built ${"2026-10-24T12:55:52.344Z"})`
   };
 }, version2, version_default;
 var init_version = __esm(() => {
@@ -545883,7 +545964,7 @@ function WelcomeV2() {
             dimColor: true,
             children: [
               "v",
-              "0.4.27",
+              "0.4.28",
               " "
             ]
           }, undefined, true, undefined, this)
@@ -546083,7 +546164,7 @@ function WelcomeV2() {
           dimColor: true,
           children: [
             "v",
-            "0.4.27",
+            "0.4.28",
             " "
           ]
         }, undefined, true, undefined, this)
@@ -546309,7 +546390,7 @@ function AppleTerminalWelcomeV2(t0) {
         dimColor: true,
         children: [
           "v",
-          "0.4.27",
+          "0.4.28",
           " "
         ]
       }, undefined, true, undefined, this);
@@ -546563,7 +546644,7 @@ function AppleTerminalWelcomeV2(t0) {
       dimColor: true,
       children: [
         "v",
-        "0.4.27",
+        "0.4.28",
         " "
       ]
     }, undefined, true, undefined, this);
@@ -567320,7 +567401,7 @@ Usage: claude --remote "your task description"`, () => gracefulShutdown(1));
         pendingHookMessages
       }, renderAndRun);
     }
-  }).version("0.4.27 (OpenCow)", "-v, --version", "Output the version number");
+  }).version("0.4.28 (OpenCow)", "-v, --version", "Output the version number");
   program.option("-w, --worktree [name]", "Create a new git worktree for this session (optionally specify a name)");
   program.option("--tmux", "Create a tmux session for the worktree (requires --worktree). Uses iTerm2 native panes when available; use --tmux=classic for traditional tmux.");
   if (canUserConfigureAdvisor()) {
@@ -567915,7 +567996,7 @@ if (false) {}
 async function main2() {
   const args = process.argv.slice(2);
   if (args.length === 1 && (args[0] === "--version" || args[0] === "-v" || args[0] === "-V")) {
-    console.log(`${"0.4.27"} (OpenCow)`);
+    console.log(`${"0.4.28"} (OpenCow)`);
     return;
   }
   if (args.includes("--provider")) {
@@ -568015,4 +568096,4 @@ async function main2() {
 }
 main2();
 
-//# debugId=25745C572ABF064464756E2164756E21
+//# debugId=9998D5AD757C65B264756E2164756E21

package/dist/client.js

@@ -119774,6 +119774,10 @@ function tokenCountWithEstimation(messages) {
       }
       return getTokenCountFromUsage(usage) + roughTokenCountEstimationForMessages(messages.slice(i + 1));
     }
+    const baselineTokens = message?.contextBaselineTokens;
+    if (typeof baselineTokens === "number" && Number.isFinite(baselineTokens) && baselineTokens >= 0) {
+      return baselineTokens + roughTokenCountEstimationForMessages(messages.slice(i + 1));
+    }
     i--;
   }
   return roughTokenCountEstimationForMessages(messages);
@@ -120441,6 +120445,75 @@ var init_contextAnalysis = __esm(() => {
   init_slowOperations();
 });
 
+// src/session/contextSnapshot.ts
+function cloneSnapshotMessage(message) {
+  if (message.type !== "system" || message.subtype !== "compact_boundary") {
+    return message;
+  }
+  const { contextSnapshot: _ignored, ...compactMetadata } = message.compactMetadata;
+  return {
+    ...message,
+    compactMetadata
+  };
+}
+function isSnapshotMessage(message) {
+  return CONTEXT_SNAPSHOT_MESSAGE_TYPES.has(message.type);
+}
+function buildContextSnapshot(messages) {
+  const snapshotMessages = messages.filter(isSnapshotMessage).map(cloneSnapshotMessage);
+  if (snapshotMessages.length === 0)
+    return;
+  return {
+    schemaVersion: 1,
+    messages: snapshotMessages,
+    baselineTokens: tokenCountWithEstimation(snapshotMessages)
+  };
+}
+function isRecord2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isValidSnapshotMessage(value) {
+  if (!isRecord2(value) || typeof value.type !== "string")
+    return false;
+  return CONTEXT_SNAPSHOT_MESSAGE_TYPES.has(value.type);
+}
+function normalizeContextSnapshot(raw) {
+  if (!isRecord2(raw)) {
+    throw new Error("Invalid context snapshot: expected an object");
+  }
+  if (raw.schemaVersion !== 1) {
+    throw new Error(`Invalid context snapshot: unsupported schemaVersion ${String(raw.schemaVersion)}`);
+  }
+  if (!Array.isArray(raw.messages) || raw.messages.length === 0) {
+    throw new Error("Invalid context snapshot: messages must be a non-empty array");
+  }
+  if (typeof raw.baselineTokens !== "number" || !Number.isFinite(raw.baselineTokens) || raw.baselineTokens < 0) {
+    throw new Error("Invalid context snapshot: baselineTokens must be a non-negative number");
+  }
+  const messages = raw.messages.map((message, index) => {
+    if (!isValidSnapshotMessage(message)) {
+      throw new Error(`Invalid context snapshot: unsupported message at index ${index}`);
+    }
+    return message;
+  });
+  const baselineTokens = raw.baselineTokens;
+  if (baselineTokens > 0) {
+    const last = messages.at(-1);
+    last.contextBaselineTokens = baselineTokens;
+  }
+  return { messages, baselineTokens };
+}
+var CONTEXT_SNAPSHOT_MESSAGE_TYPES;
+var init_contextSnapshot = __esm(() => {
+  init_tokens();
+  CONTEXT_SNAPSHOT_MESSAGE_TYPES = new Set([
+    "assistant",
+    "user",
+    "attachment",
+    "system"
+  ]);
+});
+
 // src/providers/anthropic/rateLimits/mocking.ts
 function processRateLimitHeaders(headers) {
   if (shouldProcessMockLimits()) {
@@ -122554,6 +122627,9 @@ function wrapBodyTransportError(error) {
   return new APIConnectionError({ message: error.message, cause: error });
 }
 function toReplayableStreamError(error) {
+  if (error instanceof EmptyStreamError) {
+    return new APIConnectionError({ message: error.message, cause: error });
+  }
   const wrapped = error instanceof Error && error.message.startsWith(STREAM_WATCHDOG_ABORT_PREFIX) ? new APIConnectionError({ message: error.message, cause: error }) : wrapBodyTransportError(error);
   if (!(wrapped instanceof APIConnectionError) || wrapped instanceof APIConnectionTimeoutError || extractConnectionErrorDetails(wrapped)?.isSSLError) {
     return null;
@@ -123012,7 +123088,7 @@ function getRateLimitResetDelayMs(error) {
   }
   return null;
 }
-var abortError = () => new APIUserAbortError, DEFAULT_MAX_RETRIES = 10, FLOOR_OUTPUT_TOKENS = 3000, MAX_529_RETRIES = 3, BASE_DELAY_MS = 500, FOREGROUND_529_RETRY_SOURCES, CONNECTION_WAIT_INITIAL_DELAY_MS = 5000, CONNECTION_WAIT_MAX_DELAY_MS = 60000, BODY_TRANSPORT_FAILURE_RE, STREAM_WATCHDOG_ABORT_PREFIX = "Stream idle timeout", PERSISTENT_MAX_BACKOFF_MS, PERSISTENT_RESET_CAP_MS, HEARTBEAT_INTERVAL_MS = 30000, DEFAULT_CONNECTION_WAIT_BACKOFF, CannotRetryError, FallbackTriggeredError, DEFAULT_FAST_MODE_FALLBACK_HOLD_MS, SHORT_RETRY_THRESHOLD_MS, MIN_COOLDOWN_MS;
+var abortError = () => new APIUserAbortError, DEFAULT_MAX_RETRIES = 10, FLOOR_OUTPUT_TOKENS = 3000, MAX_529_RETRIES = 3, BASE_DELAY_MS = 500, FOREGROUND_529_RETRY_SOURCES, CONNECTION_WAIT_INITIAL_DELAY_MS = 5000, CONNECTION_WAIT_MAX_DELAY_MS = 60000, BODY_TRANSPORT_FAILURE_RE, STREAM_WATCHDOG_ABORT_PREFIX = "Stream idle timeout", EmptyStreamError, PERSISTENT_MAX_BACKOFF_MS, PERSISTENT_RESET_CAP_MS, HEARTBEAT_INTERVAL_MS = 30000, DEFAULT_CONNECTION_WAIT_BACKOFF, CannotRetryError, FallbackTriggeredError, DEFAULT_FAST_MODE_FALLBACK_HOLD_MS, SHORT_RETRY_THRESHOLD_MS, MIN_COOLDOWN_MS;
 var init_retry = __esm(() => {
   init_sdk();
   init_aws();
@@ -123049,6 +123125,12 @@ var init_retry = __esm(() => {
     ...[]
   ]);
   BODY_TRANSPORT_FAILURE_RE = /socket connection was closed|^terminated$|other side closed|fetch failed/i;
+  EmptyStreamError = class EmptyStreamError extends Error {
+    constructor(message = "Stream ended before completing the response") {
+      super(message);
+      this.name = "EmptyStreamError";
+    }
+  };
   PERSISTENT_MAX_BACKOFF_MS = 5 * 60 * 1000;
   PERSISTENT_RESET_CAP_MS = 6 * 60 * 60 * 1000;
   DEFAULT_CONNECTION_WAIT_BACKOFF = {
@@ -179946,6 +180028,11 @@ var init_coreSchemas = __esm(() => {
       trigger: _enum(["manual", "auto"]),
       pre_tokens: number2(),
       post_tokens: number2().optional().describe("Estimated resulting context size after compaction."),
+      context_snapshot: object2({
+        schemaVersion: literal(1),
+        messages: array(unknown()),
+        baselineTokens: number2()
+      }).optional().describe("Opaque canonical post-compact context. Hosts persist and return it unchanged via Options.initialContextSnapshot."),
       preserved_segment: object2({
         head_uuid: UUIDPlaceholder(),
         anchor_uuid: UUIDPlaceholder(),
@@ -214416,7 +214503,7 @@ async function loadPluginSettings(pluginPath, manifest) {
   try {
     const content = await getFsImplementation().readFile(settingsJsonPath, { encoding: "utf-8" });
     const parsed = jsonParse(content);
-    if (isRecord2(parsed)) {
+    if (isRecord3(parsed)) {
       const filtered = parsePluginSettings(parsed);
       if (filtered) {
         logForDebugging(`Loaded settings from settings.json for plugin ${manifest.name}`);
@@ -215095,7 +215182,7 @@ function cachePluginSettings(plugins) {
     logForDebugging(`Cached plugin settings with keys: ${Object.keys(settings).join(", ")}`);
   }
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var PluginSettingsSchema, loadAllPlugins, loadAllPluginsCacheOnly;
@@ -227296,7 +227383,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-10-20T14:00:47.620Z").getTime();
+  const buildTime = new Date("2026-10-24T12:55:52.344Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -228494,6 +228581,15 @@ function buildPostCompactMessages(result) {
     ...result.hookResults
   ];
 }
+function attachContextSnapshot(result) {
+  if (!result.boundaryMarker?.compactMetadata)
+    return result;
+  const snapshot = buildContextSnapshot(buildPostCompactMessages(result));
+  if (snapshot) {
+    result.boundaryMarker.compactMetadata.contextSnapshot = snapshot;
+  }
+  return result;
+}
 function annotateBoundaryWithPreservedSegment(boundary, anchorUuid, messagesToKeep) {
   const keep = messagesToKeep ?? [];
   if (keep.length === 0)
@@ -229064,6 +229160,7 @@ var init_compact = __esm(() => {
   init_debug();
   init_errors5();
   init_fileStateCache();
+  init_contextSnapshot();
   init_forkedAgent();
   init_hooks2();
   init_log2();
@@ -229686,7 +229783,7 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
     markPostCompaction();
     return {
       wasCompacted: true,
-      compactionResult: sessionMemoryResult
+      compactionResult: attachContextSnapshot(sessionMemoryResult)
     };
   }
   try {
@@ -229695,7 +229792,7 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
     runPostCompactCleanup(querySource);
     return {
       wasCompacted: true,
-      compactionResult,
+      compactionResult: attachContextSnapshot(compactionResult),
       consecutiveFailures: 0
     };
   } catch (error) {
@@ -229720,13 +229817,19 @@ async function manualCompact(messages, toolUseContext, cacheSafeParams, instruct
       setLastSummarizedMessageId(undefined);
       runPostCompactCleanup();
       markPostCompaction();
-      return { wasCompacted: true, compactionResult: sessionMemoryResult };
+      return {
+        wasCompacted: true,
+        compactionResult: attachContextSnapshot(sessionMemoryResult)
+      };
     }
   }
   const compactionResult = await deps.compactConversation(messages, toolUseContext, cacheSafeParams, false, instructions, false);
   setLastSummarizedMessageId(undefined);
   runPostCompactCleanup();
-  return { wasCompacted: true, compactionResult };
+  return {
+    wasCompacted: true,
+    compactionResult: attachContextSnapshot(compactionResult)
+  };
 }
 var MAX_OUTPUT_TOKENS_FOR_SUMMARY = 20000, AUTOCOMPACT_BUFFER_TOKENS = 13000, WARNING_THRESHOLD_BUFFER_TOKENS = 20000, ERROR_THRESHOLD_BUFFER_TOKENS = 20000, MANUAL_COMPACT_BUFFER_TOKENS = 3000, MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES = 3;
 var init_autoCompact = __esm(() => {
@@ -238778,12 +238881,15 @@ ${deferredToolList}
         throw new Error("Stream idle timeout - no chunks received");
       }
       if (!partialMessage || newMessages.length === 0 && !stopReason) {
-        logForDebugging(!partialMessage ? "Stream completed without receiving message_start event - triggering non-streaming fallback" : "Stream completed with message_start but no content blocks completed - triggering non-streaming fallback", { level: "error" });
+        logForDebugging(!partialMessage ? "Stream completed without receiving message_start event - triggering non-streaming fallback" : "Stream completed with message_start but no content blocks completed - incomplete stream", { level: "error" });
         logEvent("tengu_stream_no_events", {
           model: options.model,
           request_id: streamRequestId ?? "unknown"
         });
-        throw new Error("Stream ended without receiving any events");
+        if (!partialMessage) {
+          throw new Error("Stream ended without receiving any events");
+        }
+        throw new EmptyStreamError;
       }
       if (stallCount > 0) {
         logForDebugging(`Streaming completed with ${stallCount} stall(s), total stall time: ${(totalStallTime / 1000).toFixed(1)}s`, { level: "warn" });
@@ -238828,6 +238934,9 @@ ${deferredToolList}
           throw new APIConnectionTimeoutError({ message: "Request timed out" });
         }
       }
+      if (options.streamReplayEscape && newMessages.length === 0 && !signal.aborted && toReplayableStreamError(streamingError)) {
+        throw streamingError;
+      }
       const disableFallback = isEnvTruthy(resolveEnvVar("DISABLE_NONSTREAMING_FALLBACK")) || getFeatureValue_CACHED_MAY_BE_STALE("tengu_disable_streaming_to_non_streaming_fallback", false);
       if (disableFallback) {
         logForDebugging(`Error streaming (non-streaming fallback disabled): ${errorMessage(streamingError)}`, { level: "error" });
@@ -270690,6 +270799,9 @@ function toSDKCompactMetadata(meta) {
     trigger: meta.trigger,
     pre_tokens: meta.preTokens,
     ...meta.postTokens !== undefined && { post_tokens: meta.postTokens },
+    ...meta.contextSnapshot !== undefined && {
+      context_snapshot: meta.contextSnapshot
+    },
     ...seg && {
       preserved_segment: {
         head_uuid: seg.headUuid,
@@ -272942,6 +273054,7 @@ function registerSdkInlineSkillHandler() {
 init_backgroundAbortRegistry();
 init_backgroundTaskScope();
 init_sessionStorage();
+init_contextSnapshot();
 init_branding();
 init_hooks2();
 init_debug();
@@ -278977,7 +279090,9 @@ function runSdkQueryRuntime(params) {
   const appStateStore = buildAppStateStore(applyFileCheckpointingInitialState(applyDisallowedTools(applyPermissionMode(getDefaultAppState(), options.permissionMode), options.disallowedTools), options.fileCheckpointing?.initialState), fileCheckpointingOnChange);
   const releaseBackgroundTaskScope = bindBackgroundTaskScope(appStateStore.setAppState, ownership.backgroundTaskScope);
   const initialMessagesForReplay = options.resume ? loadAndRestampHistoricalMessages(options.resume, queryContext.identity.sessionId, options.initialMessages) : options.initialMessages;
-  let mutableMessages = normalizeInitialMessages(initialMessagesForReplay);
+  const contextSnapshot = options.initialContextSnapshot === undefined ? undefined : normalizeContextSnapshot(options.initialContextSnapshot);
+  const initialMessages = normalizeInitialMessages(initialMessagesForReplay);
+  let mutableMessages = contextSnapshot ? [...contextSnapshot.messages, ...initialMessages] : initialMessages;
   let readFileCache = createFileStateCacheWithSizeLimit(DEFAULT_READ_FILE_CACHE_SIZE);
   const dynamicClients = [];
   const sdkClients = [];
@@ -280500,4 +280615,4 @@ export {
   watchScheduledTasks
 };
 
-//# debugId=7F28B624A121A3CF64756E2164756E21
+//# debugId=E18A4788D5E5D36064756E2164756E21

package/dist/controller/compact/compact.d.ts

@@ -3,7 +3,7 @@ import type { QuerySource } from '../../constants/querySource.js';
 import type { CanUseToolFn } from '../../types/canUseTool.js';
 import type { ToolUseContext } from '../../Tool.js';
 import type { AgentId } from '../../types/ids.js';
-import type { AssistantMessage, AttachmentMessage, HookResultMessage, Message, PartialCompactDirection, SystemCompactBoundaryMessage, SystemMessage, UserMessage } from '../../types/message.js';
+import type { AssistantMessage, AttachmentMessage, HookResultMessage, Message, PartialCompactDirection, SystemCompactBoundaryMessage, UserMessage } from '../../types/message.js';
 import { type CacheSafeParams } from '../../session/forkedAgent.js';
 import { getTokenUsage } from '../../session/tokens.js';
 export declare const POST_COMPACT_MAX_FILES_TO_RESTORE = 5;
@@ -53,7 +53,7 @@ export declare const ERROR_MESSAGE_PROMPT_TOO_LONG = "Conversation too long. Pre
 export declare const ERROR_MESSAGE_USER_ABORT = "API Error: Request was aborted.";
 export declare const ERROR_MESSAGE_INCOMPLETE_RESPONSE = "Compaction interrupted \u00B7 This may be due to network issues \u2014 please try again.";
 export interface CompactionResult {
-    boundaryMarker: SystemMessage;
+    boundaryMarker: SystemCompactBoundaryMessage;
     summaryMessages: UserMessage[];
     attachments: AttachmentMessage[];
     hookResults: HookResultMessage[];
@@ -82,6 +82,12 @@ export type RecompactionInfo = {
  * Order: boundaryMarker, summaryMessages, messagesToKeep, attachments, hookResults
  */
 export declare function buildPostCompactMessages(result: CompactionResult): Message[];
+/**
+ * Attach the complete post-compact context to the public boundary metadata.
+ * The snapshot is built before the boundary is annotated so its embedded copy
+ * cannot reference itself.
+ */
+export declare function attachContextSnapshot(result: CompactionResult): CompactionResult;
 /**
  * Annotate a compact boundary with relink metadata for messagesToKeep.
  * Preserved messages keep their original parentUuids on disk (dedup-skipped);

package/dist/controller/loop.d.ts

@@ -28,7 +28,8 @@ export declare function adjustParamsForNonStreaming<T extends {
 export type Options = {
     /**
      * 内部：由 replayStreamOnTransportError 置位。为 true 时，读流阶段的可重放传输错误
-     * （且尚无完整消息送出）作为异常抛给调用方重放，而不是转成 assistant 错误消息。
+     * （且尚无完整消息送出）优先作为异常抛给调用方重放，而不是先走 non-streaming
+     * fallback 或转成 assistant 错误消息；预算用尽后该标记为 false，恢复原路径。
      */
     streamReplayEscape?: boolean;
     getToolPermissionContext: () => Promise<ToolPermissionContext>;

package/dist/entrypoints/sdk/controlSchemas.d.ts

@@ -4389,6 +4389,11 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
         }>;
         pre_tokens: z.ZodNumber;
         post_tokens: z.ZodOptional<z.ZodNumber>;
+        context_snapshot: z.ZodOptional<z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            messages: z.ZodArray<z.ZodUnknown>;
+            baselineTokens: z.ZodNumber;
+        }, z.core.$strip>>;
         preserved_segment: z.ZodOptional<z.ZodObject<{
             head_uuid: z.ZodString;
             anchor_uuid: z.ZodString;

package/dist/entrypoints/sdk/coreSchemas.d.ts

@@ -2509,6 +2509,11 @@ export declare const SDKCompactBoundaryMessageSchema: () => z.ZodObject<{
         }>;
         pre_tokens: z.ZodNumber;
         post_tokens: z.ZodOptional<z.ZodNumber>;
+        context_snapshot: z.ZodOptional<z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            messages: z.ZodArray<z.ZodUnknown>;
+            baselineTokens: z.ZodNumber;
+        }, z.core.$strip>>;
         preserved_segment: z.ZodOptional<z.ZodObject<{
             head_uuid: z.ZodString;
             anchor_uuid: z.ZodString;
@@ -2918,6 +2923,11 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
         }>;
         pre_tokens: z.ZodNumber;
         post_tokens: z.ZodOptional<z.ZodNumber>;
+        context_snapshot: z.ZodOptional<z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            messages: z.ZodArray<z.ZodUnknown>;
+            baselineTokens: z.ZodNumber;
+        }, z.core.$strip>>;
         preserved_segment: z.ZodOptional<z.ZodObject<{
             head_uuid: z.ZodString;
             anchor_uuid: z.ZodString;

package/dist/entrypoints/sdk/runtimeTypes.d.ts

@@ -1,6 +1,8 @@
 import type { ChildProcessWithoutNullStreams } from 'node:child_process';
 import type { ModelProviders } from '../../providers/shared/routing.js';
 import type { UploadMediaFn } from '../../types/toolRuntime.js';
+import type { SDKContextSnapshot } from '../../types/contextSnapshot.js';
+export type { SDKContextSnapshot } from '../../types/contextSnapshot.js';
 export type { ModelProviders, ModelProviderConfig, } from '../../providers/shared/routing.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
@@ -527,6 +529,17 @@ export type Options = {
      */
     spawnClaudeCodeProcess?: (opts: SpawnOptions) => SpawnedProcess;
     initialMessages?: unknown[];
+    /**
+     * Opaque canonical post-compact context returned by a previous
+     * `compact_metadata.context_snapshot`. Hosts persist it unchanged and pass
+     * it back after restart. When both this and `initialMessages` are provided,
+     * the snapshot is restored first and `initialMessages` are appended as the
+     * tail (normally events recorded after the snapshot).
+     *
+     * Invalid snapshots throw instead of silently falling back to a smaller
+     * context.
+     */
+    initialContextSnapshot?: SDKContextSnapshot;
     /**
      * Controls whether the SDK performs ANY filesystem reads of its own
      * during session execution.

package/dist/providers/shared/retry.d.ts

@@ -10,7 +10,19 @@ export declare const BASE_DELAY_MS = 500;
  * 只认传输特征（cause 带系统错误码或固定文案），普通 TypeError 仍按程序错误处理。
  */
 export declare function wrapBodyTransportError(error: unknown): unknown;
-/** 读流阶段的传输中断（对端关闭、socket 断开、空闲看门狗中止）可以整条请求重放；其余不行。 */
+/**
+ * 已收到 message_start、但流在任何完整 content block / stop_reason 之前结束。
+ * 这类空流可能由代理瞬断造成，且尚未提交任何模型输出，可以安全地整条请求重放。
+ * 没有 message_start 的 200 空响应不归入此类：它更像网关不兼容 SSE，保留
+ * non-streaming fallback（见 controller/loop.ts）。
+ *
+ * 重放前可能已经向消费方 yield 过半截 stream_event。消费方必须在新的
+ * message_start 到达时重置未完成的流式内容；SDK 不保证撤回已经展示的部分。
+ */
+export declare class EmptyStreamError extends Error {
+    constructor(message?: string);
+}
+/** 读流阶段的传输中断（对端关闭、socket 断开、空闲看门狗中止、空流）可以整条请求重放；其余不行。 */
 export declare function toReplayableStreamError(error: unknown): APIConnectionError | null;
 /**
  * 流式响应读到一半断开、且还没有任何完整消息送出时，整个流式请求重放。

package/dist/sdk.js

@@ -119774,6 +119774,10 @@ function tokenCountWithEstimation(messages) {
       }
       return getTokenCountFromUsage(usage) + roughTokenCountEstimationForMessages(messages.slice(i + 1));
     }
+    const baselineTokens = message?.contextBaselineTokens;
+    if (typeof baselineTokens === "number" && Number.isFinite(baselineTokens) && baselineTokens >= 0) {
+      return baselineTokens + roughTokenCountEstimationForMessages(messages.slice(i + 1));
+    }
     i--;
   }
   return roughTokenCountEstimationForMessages(messages);
@@ -120441,6 +120445,75 @@ var init_contextAnalysis = __esm(() => {
   init_slowOperations();
 });
 
+// src/session/contextSnapshot.ts
+function cloneSnapshotMessage(message) {
+  if (message.type !== "system" || message.subtype !== "compact_boundary") {
+    return message;
+  }
+  const { contextSnapshot: _ignored, ...compactMetadata } = message.compactMetadata;
+  return {
+    ...message,
+    compactMetadata
+  };
+}
+function isSnapshotMessage(message) {
+  return CONTEXT_SNAPSHOT_MESSAGE_TYPES.has(message.type);
+}
+function buildContextSnapshot(messages) {
+  const snapshotMessages = messages.filter(isSnapshotMessage).map(cloneSnapshotMessage);
+  if (snapshotMessages.length === 0)
+    return;
+  return {
+    schemaVersion: 1,
+    messages: snapshotMessages,
+    baselineTokens: tokenCountWithEstimation(snapshotMessages)
+  };
+}
+function isRecord2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isValidSnapshotMessage(value) {
+  if (!isRecord2(value) || typeof value.type !== "string")
+    return false;
+  return CONTEXT_SNAPSHOT_MESSAGE_TYPES.has(value.type);
+}
+function normalizeContextSnapshot(raw) {
+  if (!isRecord2(raw)) {
+    throw new Error("Invalid context snapshot: expected an object");
+  }
+  if (raw.schemaVersion !== 1) {
+    throw new Error(`Invalid context snapshot: unsupported schemaVersion ${String(raw.schemaVersion)}`);
+  }
+  if (!Array.isArray(raw.messages) || raw.messages.length === 0) {
+    throw new Error("Invalid context snapshot: messages must be a non-empty array");
+  }
+  if (typeof raw.baselineTokens !== "number" || !Number.isFinite(raw.baselineTokens) || raw.baselineTokens < 0) {
+    throw new Error("Invalid context snapshot: baselineTokens must be a non-negative number");
+  }
+  const messages = raw.messages.map((message, index) => {
+    if (!isValidSnapshotMessage(message)) {
+      throw new Error(`Invalid context snapshot: unsupported message at index ${index}`);
+    }
+    return message;
+  });
+  const baselineTokens = raw.baselineTokens;
+  if (baselineTokens > 0) {
+    const last = messages.at(-1);
+    last.contextBaselineTokens = baselineTokens;
+  }
+  return { messages, baselineTokens };
+}
+var CONTEXT_SNAPSHOT_MESSAGE_TYPES;
+var init_contextSnapshot = __esm(() => {
+  init_tokens();
+  CONTEXT_SNAPSHOT_MESSAGE_TYPES = new Set([
+    "assistant",
+    "user",
+    "attachment",
+    "system"
+  ]);
+});
+
 // src/providers/anthropic/rateLimits/mocking.ts
 function processRateLimitHeaders(headers) {
   if (shouldProcessMockLimits()) {
@@ -122554,6 +122627,9 @@ function wrapBodyTransportError(error) {
   return new APIConnectionError({ message: error.message, cause: error });
 }
 function toReplayableStreamError(error) {
+  if (error instanceof EmptyStreamError) {
+    return new APIConnectionError({ message: error.message, cause: error });
+  }
   const wrapped = error instanceof Error && error.message.startsWith(STREAM_WATCHDOG_ABORT_PREFIX) ? new APIConnectionError({ message: error.message, cause: error }) : wrapBodyTransportError(error);
   if (!(wrapped instanceof APIConnectionError) || wrapped instanceof APIConnectionTimeoutError || extractConnectionErrorDetails(wrapped)?.isSSLError) {
     return null;
@@ -123012,7 +123088,7 @@ function getRateLimitResetDelayMs(error) {
   }
   return null;
 }
-var abortError = () => new APIUserAbortError, DEFAULT_MAX_RETRIES = 10, FLOOR_OUTPUT_TOKENS = 3000, MAX_529_RETRIES = 3, BASE_DELAY_MS = 500, FOREGROUND_529_RETRY_SOURCES, CONNECTION_WAIT_INITIAL_DELAY_MS = 5000, CONNECTION_WAIT_MAX_DELAY_MS = 60000, BODY_TRANSPORT_FAILURE_RE, STREAM_WATCHDOG_ABORT_PREFIX = "Stream idle timeout", PERSISTENT_MAX_BACKOFF_MS, PERSISTENT_RESET_CAP_MS, HEARTBEAT_INTERVAL_MS = 30000, DEFAULT_CONNECTION_WAIT_BACKOFF, CannotRetryError, FallbackTriggeredError, DEFAULT_FAST_MODE_FALLBACK_HOLD_MS, SHORT_RETRY_THRESHOLD_MS, MIN_COOLDOWN_MS;
+var abortError = () => new APIUserAbortError, DEFAULT_MAX_RETRIES = 10, FLOOR_OUTPUT_TOKENS = 3000, MAX_529_RETRIES = 3, BASE_DELAY_MS = 500, FOREGROUND_529_RETRY_SOURCES, CONNECTION_WAIT_INITIAL_DELAY_MS = 5000, CONNECTION_WAIT_MAX_DELAY_MS = 60000, BODY_TRANSPORT_FAILURE_RE, STREAM_WATCHDOG_ABORT_PREFIX = "Stream idle timeout", EmptyStreamError, PERSISTENT_MAX_BACKOFF_MS, PERSISTENT_RESET_CAP_MS, HEARTBEAT_INTERVAL_MS = 30000, DEFAULT_CONNECTION_WAIT_BACKOFF, CannotRetryError, FallbackTriggeredError, DEFAULT_FAST_MODE_FALLBACK_HOLD_MS, SHORT_RETRY_THRESHOLD_MS, MIN_COOLDOWN_MS;
 var init_retry = __esm(() => {
   init_sdk();
   init_aws();
@@ -123049,6 +123125,12 @@ var init_retry = __esm(() => {
     ...[]
   ]);
   BODY_TRANSPORT_FAILURE_RE = /socket connection was closed|^terminated$|other side closed|fetch failed/i;
+  EmptyStreamError = class EmptyStreamError extends Error {
+    constructor(message = "Stream ended before completing the response") {
+      super(message);
+      this.name = "EmptyStreamError";
+    }
+  };
   PERSISTENT_MAX_BACKOFF_MS = 5 * 60 * 1000;
   PERSISTENT_RESET_CAP_MS = 6 * 60 * 60 * 1000;
   DEFAULT_CONNECTION_WAIT_BACKOFF = {
@@ -179946,6 +180028,11 @@ var init_coreSchemas = __esm(() => {
       trigger: _enum(["manual", "auto"]),
       pre_tokens: number2(),
       post_tokens: number2().optional().describe("Estimated resulting context size after compaction."),
+      context_snapshot: object2({
+        schemaVersion: literal(1),
+        messages: array(unknown()),
+        baselineTokens: number2()
+      }).optional().describe("Opaque canonical post-compact context. Hosts persist and return it unchanged via Options.initialContextSnapshot."),
       preserved_segment: object2({
         head_uuid: UUIDPlaceholder(),
         anchor_uuid: UUIDPlaceholder(),
@@ -214416,7 +214503,7 @@ async function loadPluginSettings(pluginPath, manifest) {
   try {
     const content = await getFsImplementation().readFile(settingsJsonPath, { encoding: "utf-8" });
     const parsed = jsonParse(content);
-    if (isRecord2(parsed)) {
+    if (isRecord3(parsed)) {
       const filtered = parsePluginSettings(parsed);
       if (filtered) {
         logForDebugging(`Loaded settings from settings.json for plugin ${manifest.name}`);
@@ -215095,7 +215182,7 @@ function cachePluginSettings(plugins) {
     logForDebugging(`Cached plugin settings with keys: ${Object.keys(settings).join(", ")}`);
   }
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var PluginSettingsSchema, loadAllPlugins, loadAllPluginsCacheOnly;
@@ -227296,7 +227383,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-10-20T14:00:47.620Z").getTime();
+  const buildTime = new Date("2026-10-24T12:55:52.344Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -228494,6 +228581,15 @@ function buildPostCompactMessages(result) {
     ...result.hookResults
   ];
 }
+function attachContextSnapshot(result) {
+  if (!result.boundaryMarker?.compactMetadata)
+    return result;
+  const snapshot = buildContextSnapshot(buildPostCompactMessages(result));
+  if (snapshot) {
+    result.boundaryMarker.compactMetadata.contextSnapshot = snapshot;
+  }
+  return result;
+}
 function annotateBoundaryWithPreservedSegment(boundary, anchorUuid, messagesToKeep) {
   const keep = messagesToKeep ?? [];
   if (keep.length === 0)
@@ -229064,6 +229160,7 @@ var init_compact = __esm(() => {
   init_debug();
   init_errors5();
   init_fileStateCache();
+  init_contextSnapshot();
   init_forkedAgent();
   init_hooks2();
   init_log2();
@@ -229686,7 +229783,7 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
     markPostCompaction();
     return {
       wasCompacted: true,
-      compactionResult: sessionMemoryResult
+      compactionResult: attachContextSnapshot(sessionMemoryResult)
     };
   }
   try {
@@ -229695,7 +229792,7 @@ async function autoCompactIfNeeded(messages, toolUseContext, cacheSafeParams, qu
     runPostCompactCleanup(querySource);
     return {
       wasCompacted: true,
-      compactionResult,
+      compactionResult: attachContextSnapshot(compactionResult),
       consecutiveFailures: 0
     };
   } catch (error) {
@@ -229720,13 +229817,19 @@ async function manualCompact(messages, toolUseContext, cacheSafeParams, instruct
       setLastSummarizedMessageId(undefined);
       runPostCompactCleanup();
       markPostCompaction();
-      return { wasCompacted: true, compactionResult: sessionMemoryResult };
+      return {
+        wasCompacted: true,
+        compactionResult: attachContextSnapshot(sessionMemoryResult)
+      };
     }
   }
   const compactionResult = await deps.compactConversation(messages, toolUseContext, cacheSafeParams, false, instructions, false);
   setLastSummarizedMessageId(undefined);
   runPostCompactCleanup();
-  return { wasCompacted: true, compactionResult };
+  return {
+    wasCompacted: true,
+    compactionResult: attachContextSnapshot(compactionResult)
+  };
 }
 var MAX_OUTPUT_TOKENS_FOR_SUMMARY = 20000, AUTOCOMPACT_BUFFER_TOKENS = 13000, WARNING_THRESHOLD_BUFFER_TOKENS = 20000, ERROR_THRESHOLD_BUFFER_TOKENS = 20000, MANUAL_COMPACT_BUFFER_TOKENS = 3000, MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES = 3;
 var init_autoCompact = __esm(() => {
@@ -238778,12 +238881,15 @@ ${deferredToolList}
         throw new Error("Stream idle timeout - no chunks received");
       }
       if (!partialMessage || newMessages.length === 0 && !stopReason) {
-        logForDebugging(!partialMessage ? "Stream completed without receiving message_start event - triggering non-streaming fallback" : "Stream completed with message_start but no content blocks completed - triggering non-streaming fallback", { level: "error" });
+        logForDebugging(!partialMessage ? "Stream completed without receiving message_start event - triggering non-streaming fallback" : "Stream completed with message_start but no content blocks completed - incomplete stream", { level: "error" });
         logEvent("tengu_stream_no_events", {
           model: options.model,
           request_id: streamRequestId ?? "unknown"
         });
-        throw new Error("Stream ended without receiving any events");
+        if (!partialMessage) {
+          throw new Error("Stream ended without receiving any events");
+        }
+        throw new EmptyStreamError;
       }
       if (stallCount > 0) {
         logForDebugging(`Streaming completed with ${stallCount} stall(s), total stall time: ${(totalStallTime / 1000).toFixed(1)}s`, { level: "warn" });
@@ -238828,6 +238934,9 @@ ${deferredToolList}
           throw new APIConnectionTimeoutError({ message: "Request timed out" });
         }
       }
+      if (options.streamReplayEscape && newMessages.length === 0 && !signal.aborted && toReplayableStreamError(streamingError)) {
+        throw streamingError;
+      }
       const disableFallback = isEnvTruthy(resolveEnvVar("DISABLE_NONSTREAMING_FALLBACK")) || getFeatureValue_CACHED_MAY_BE_STALE("tengu_disable_streaming_to_non_streaming_fallback", false);
       if (disableFallback) {
         logForDebugging(`Error streaming (non-streaming fallback disabled): ${errorMessage(streamingError)}`, { level: "error" });
@@ -270690,6 +270799,9 @@ function toSDKCompactMetadata(meta) {
     trigger: meta.trigger,
     pre_tokens: meta.preTokens,
     ...meta.postTokens !== undefined && { post_tokens: meta.postTokens },
+    ...meta.contextSnapshot !== undefined && {
+      context_snapshot: meta.contextSnapshot
+    },
     ...seg && {
       preserved_segment: {
         head_uuid: seg.headUuid,
@@ -272942,6 +273054,7 @@ function registerSdkInlineSkillHandler() {
 init_backgroundAbortRegistry();
 init_backgroundTaskScope();
 init_sessionStorage();
+init_contextSnapshot();
 init_branding();
 init_hooks2();
 init_debug();
@@ -278977,7 +279090,9 @@ function runSdkQueryRuntime(params) {
   const appStateStore = buildAppStateStore(applyFileCheckpointingInitialState(applyDisallowedTools(applyPermissionMode(getDefaultAppState(), options.permissionMode), options.disallowedTools), options.fileCheckpointing?.initialState), fileCheckpointingOnChange);
   const releaseBackgroundTaskScope = bindBackgroundTaskScope(appStateStore.setAppState, ownership.backgroundTaskScope);
   const initialMessagesForReplay = options.resume ? loadAndRestampHistoricalMessages(options.resume, queryContext.identity.sessionId, options.initialMessages) : options.initialMessages;
-  let mutableMessages = normalizeInitialMessages(initialMessagesForReplay);
+  const contextSnapshot = options.initialContextSnapshot === undefined ? undefined : normalizeContextSnapshot(options.initialContextSnapshot);
+  const initialMessages = normalizeInitialMessages(initialMessagesForReplay);
+  let mutableMessages = contextSnapshot ? [...contextSnapshot.messages, ...initialMessages] : initialMessages;
   let readFileCache = createFileStateCacheWithSizeLimit(DEFAULT_READ_FILE_CACHE_SIZE);
   const dynamicClients = [];
   const sdkClients = [];
@@ -280500,4 +280615,4 @@ export {
   watchScheduledTasks
 };
 
-//# debugId=170548B7935A529064756E2164756E21
+//# debugId=FB4FE49FF3A1776C64756E2164756E21

package/dist/session/contextSnapshot.d.ts

@@ -0,0 +1,14 @@
+import type { Message } from '../types/message.js';
+import type { SDKContextSnapshot } from '../types/contextSnapshot.js';
+export declare function buildContextSnapshot(messages: readonly Message[]): SDKContextSnapshot | undefined;
+/**
+ * Validates a persisted snapshot and restores its token baseline marker.
+ *
+ * Invalid snapshots throw instead of silently falling back to a smaller
+ * context: a corrupt persisted snapshot is a host data problem that must be
+ * visible, not converted into a different model context.
+ */
+export declare function normalizeContextSnapshot(raw: unknown): {
+    messages: Message[];
+    baselineTokens: number;
+};

package/dist/types/contextSnapshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Versioned, host-persistable snapshot of the post-compact model context.
+ *
+ * `messages` intentionally stays opaque at the public boundary: the SDK owns
+ * the internal canonical message shapes, while hosts only persist and return
+ * the snapshot unchanged.
+ */
+export type SDKContextSnapshot = {
+    schemaVersion: 1;
+    messages: readonly unknown[];
+    /**
+     * Estimated or API-reported size of `messages` at snapshot creation time.
+     * Used as the context baseline until a later assistant response carries real
+     * usage.
+     */
+    baselineTokens: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencow-ai/opencow-agent-sdk",
-  "version": "0.4.27",
+  "version": "0.4.28",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",