@deepstrike/sdk 0.2.10 → 0.2.12

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { WorkflowNodeSpec } from "./types/agent.js";
 export interface TextPart {
     type: "text";
     text: string;
@@ -72,6 +73,18 @@ export interface ToolCallEvent extends StreamEvent {
     name: string;
     arguments: Record<string, unknown>;
 }
+export interface UsageEvent extends StreamEvent {
+    type: "usage";
+    /** Full prompt size + output (the authoritative prompt size for context accounting). */
+    totalTokens: number;
+    /** Full prompt size: uncached input + cache reads + cache writes. */
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Prompt tokens served from cache this request (billed ~0.1x). Subset of inputTokens. */
+    cacheReadInputTokens?: number;
+    /** Prompt tokens written to cache this request (billed ~1.25x). Subset of inputTokens. */
+    cacheCreationInputTokens?: number;
+}
 export type ToolChunk = string | {
     type: "text";
     text: string;
@@ -116,6 +129,13 @@ export interface ToolResultEvent extends StreamEvent {
     isFatal?: boolean;
     errorKind?: ToolErrorKind;
 }
+/** R3-1: a workflow node's agent called the `submit_workflow_nodes` tool. The runner intercepts it
+ *  (it cannot apply to the child's own kernel — the workflow lives in the parent) and surfaces the
+ *  requested nodes as this event; the `runWorkflow` driver sends them to the parent kernel. */
+export interface WorkflowNodesSubmittedEvent extends StreamEvent {
+    type: "workflow_nodes_submitted";
+    nodes: WorkflowNodeSpec[];
+}
 export interface DoneEvent extends StreamEvent {
     type: "done";
     iterations: number;
@@ -161,9 +181,14 @@ export interface ToolDeniedEvent extends StreamEvent {
     reason: string;
 }
 export interface TokenUsage {
+    /** Full prompt size: uncached input + cache reads + cache writes. */
     inputTokens: number;
     outputTokens: number;
     totalTokens: number;
+    /** Prompt tokens served from cache (billed ~0.1x). Subset of inputTokens. */
+    cacheReadInputTokens?: number;
+    /** Prompt tokens written to cache (billed ~1.25x). Subset of inputTokens. */
+    cacheCreationInputTokens?: number;
 }
 export interface ProviderToolSpec {
     name: string;
@@ -228,8 +253,24 @@ export interface RenderedContext {
     systemStable?: string;
     /** Knowledge (memory retrievals, skill definitions, artifacts). Anthropic system[1] with cache_control. */
     systemKnowledge?: string;
-    /** Turns: [0] = State (task_state + signals), [1..N] = History. */
+    /** History turns only — the stable, cacheable message prefix. */
     turns: Message[];
+    /**
+     * Volatile State turn (task_state + signals), rebuilt every call. Providers
+     * render it after the cacheable history (Anthropic: after the cache breakpoint;
+     * OpenAI-family: prepended, preserving order). Absent when produced by an
+     * older binding that has not been rebuilt — then the State turn is still inside
+     * `turns[0]` and providers render `turns` as-is.
+     */
+    stateTurn?: Message;
+    /**
+     * P1-E: count of leading `turns` forming the frozen prefix — byte-stable until the next
+     * compaction. The Anthropic provider pins a deep cache breakpoint at this boundary (a long-lived
+     * cache that survives many turns and is immune to the 20-block lookback miss on heavy tool turns)
+     * and rolls the other breakpoint at the tail. Absent (older binding, or no distinct frozen region
+     * yet) ⇒ the provider falls back to the rolling-pair placement.
+     */
+    frozenPrefixLen?: number;
 }
 /**
  * Runtime execution policy advertised by a provider.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/sdk",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "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.10",
+    "@deepstrike/core": "0.2.12",
     "@google/generative-ai": "^0.24.1",
     "openai": "^5.23.2"
   },