@deepstrike/sdk 0.2.21 → 0.2.23

package/dist/types.d.ts

@@ -84,6 +84,15 @@ export interface UsageEvent extends StreamEvent {
     cacheReadInputTokens?: number;
     /** Prompt tokens written to cache this request (billed ~1.25x). Subset of inputTokens. */
     cacheCreationInputTokens?: number;
+    /** I1: per-slot pro-rata attribution of `cacheReadInputTokens`. Estimated, not authoritative —
+     *  Anthropic returns a single cache-read total, so the SDK divides it evenly across the slots
+     *  that carried a `cache_control` breakpoint on the request. Missing when the provider doesn't
+     *  honor `cache_control` (OpenAI-family auto-cache) or when no breakpoints were placed. */
+    cacheReadInputTokensBySlot?: {
+        system?: number;
+        tools?: number;
+        messages?: number;
+    };
 }
 export type ToolChunk = string | {
     type: "text";
@@ -210,6 +219,34 @@ export interface RetryConfig {
  */
 export type ProviderRunState = Record<string, unknown>;
 export type ProviderProtocol = "anthropic-messages" | "openai-chat" | "openai-responses" | "gemini";
+/**
+ * Strategy for placing Anthropic-protocol `cache_control` breakpoints across a request's
+ * static prefix (tools + system blocks) and rolling history (messages). Pass via the
+ * `extensions.cacheBreakpointStrategy` extension on every provider call; the runner already
+ * flows `RuntimeOptions.extensions` through, so setting it once on the runner propagates
+ * to every Anthropic-protocol call.
+ *
+ * Values:
+ *   - `"default"` — current production behavior: a breakpoint on the last tool (when system
+ *     is rendered as a string), one on each system block (when system blocks are present),
+ *     and the rolling message pair (last message + frozen-prefix anchor or last preceding
+ *     user turn).
+ *   - `"tools-only"` — breakpoint on the last tool only. System blocks and history go
+ *     uncached. Useful to isolate the tools-prefix cache contribution.
+ *   - `"system-only"` — breakpoints on system blocks only. No tool, no history caching.
+ *     Useful to isolate the system-prefix cache contribution.
+ *   - `"frozen-prefix"` — breakpoints on the message history only, anchored at
+ *     `frozenPrefixLen` (the compaction boundary, P1-E). Falls back to the last-message
+ *     breakpoint when no frozen prefix is set. No tools, no system caching. Useful to
+ *     stress-test the P1-E deep-anchor design.
+ *   - `"none"` — no `cache_control` anywhere. The baseline for cache-hit attribution.
+ *
+ * Strategies that disable some breakpoints still keep the structural shape (e.g. system
+ * blocks remain text blocks rather than collapsing into a single string), so the only
+ * Δ between variants is which blocks carry `cache_control`. Unrecognised strings fall
+ * back to `"default"`.
+ */
+export type CacheBreakpointStrategy = "default" | "tools-only" | "system-only" | "frozen-prefix" | "none";
 export interface ProviderDescriptor {
     provider: string;
     protocol: ProviderProtocol;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/sdk",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "description": "DeepStrike Node.js SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.99.0",
-    "@deepstrike/core": "0.2.21",
+    "@deepstrike/core": "0.2.23",
     "@google/generative-ai": "^0.24.1",
     "openai": "^5.23.2"
   },