@deepstrike/sdk 0.2.68 → 0.2.70

package/dist/types.d.ts

@@ -81,10 +81,10 @@ export interface ContentBlockFile {
     mediaType?: string;
     providerOptions?: Record<string, unknown>;
 }
-/** Legal content returned by a tool. Deliberately excludes ToolResult, so nesting is
+/** Legal content returned by a tool. Deliberately excludes ToolExecutionResult, so nesting is
  * unrepresentable in the canonical type. */
 export type ToolOutputBlock = ContentBlockText | ContentBlockImage | ContentBlockAudio | ContentBlockVideo | ContentBlockFile;
-export interface Message {
+export interface ProviderMessage {
     role: "system" | "user" | "assistant" | "tool";
     /** Plain-text content. When `contentParts` is present, this holds only the text segments. */
     content: string;
@@ -98,7 +98,7 @@ export interface ToolCall {
     arguments: string;
 }
 export type ToolErrorKind = "recoverable" | "fatal" | "governance_denied" | "provider_failure" | "timeout" | "user_interrupt";
-export interface ToolResult {
+export interface ToolExecutionResult {
     callId: string;
     output: string;
     isError: boolean;
@@ -450,7 +450,7 @@ export interface ProviderWireEvidence {
     response_id?: string;
     /** BoundedJson semantics: producers truncate to ≤4KB before landing it here. */
     raw_usage?: unknown;
-    /** The former `llm_completed.provider_replay` field, carried verbatim (P3-S2 migration). */
+    /** Provider-native replay state carried inside the wire evidence bundle. */
     replay_state?: ProviderReplay;
 }
 /**
@@ -478,7 +478,7 @@ export interface RenderedContext {
     /** Knowledge (memory retrievals, skill definitions, artifacts). Anthropic system[1] with cache_control. */
     systemKnowledge?: string;
     /** History turns only — the stable, cacheable message prefix. */
-    turns: Message[];
+    turns: ProviderMessage[];
     /**
      * Volatile State turn (task_state + signals), rebuilt every call. Providers
      * render it after the cacheable history (Anthropic: after the cache breakpoint;
@@ -486,7 +486,7 @@ export interface RenderedContext {
      * older binding that has not been rebuilt — then the State turn is still inside
      * `turns[0]` and providers render `turns` as-is.
      */
-    stateTurn?: Message;
+    stateTurn?: ProviderMessage;
     /**
      * 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
@@ -512,7 +512,16 @@ export interface RuntimePolicy {
     /** Per-run wall-clock timeout in ms. */
     timeoutMs?: number;
 }
+/** Frozen host request; scope distinguishes encoded body from a custom adapter input. */
+export interface PreparedProviderRequest {
+    readonly scope: "encoded_body" | "adapter_input";
+    readonly request: unknown;
+    readonly state: unknown;
+    stream(signal?: AbortSignal): AsyncIterable<StreamEvent>;
+    countTokens?(): Promise<PromptMeasurement>;
+}
 export interface LLMProvider {
+    prepareRequest?(context: RenderedContext, tools: ToolSchema[], extensions?: Record<string, unknown>, state?: ProviderRunState): PreparedProviderRequest;
     createRunState?(): ProviderRunState;
     descriptor?(): ProviderDescriptor;
     /**
@@ -522,7 +531,7 @@ export interface LLMProvider {
      */
     runtimePolicy?(): RuntimePolicy;
     /** Read provider-native replay fields captured after the most recent assistant turn. */
-    peekProviderReplay?(message: Pick<Message, "content" | "toolCalls">): ProviderReplay | undefined;
+    peekProviderReplay?(message: Pick<ProviderMessage, "content" | "toolCalls">): ProviderReplay | undefined;
     /**
      * P4-S1: read the transport facts captured during the most recent execution (HTTP rung count,
      * wire response id). Optional — a provider without it simply omits the telemetry and the
@@ -531,7 +540,7 @@ export interface LLMProvider {
      */
     peekTransportTelemetry?(): ProviderTransportTelemetry | undefined;
     /** Restore provider-native replay fields when rebuilding history from SessionLog. */
-    seedProviderReplay?(message: Pick<Message, "content" | "toolCalls">, replay: ProviderReplay): void;
+    seedProviderReplay?(message: Pick<ProviderMessage, "content" | "toolCalls">, replay: ProviderReplay): void;
     /**
      * Pre-flight query: would this history validate against this provider with the
      * given extensions, without sending the request? Returns the tool-call ids
@@ -551,7 +560,7 @@ export interface LLMProvider {
      * fingerprinting and durable measurement semantics are defined.
      */
     countTokens?(context: RenderedContext, tools: ToolSchema[], extensions?: Record<string, unknown>, state?: ProviderRunState): Promise<PromptMeasurement>;
-    complete(context: RenderedContext, tools: ToolSchema[], extensions?: Record<string, unknown>): Promise<Message>;
+    complete(context: RenderedContext, tools: ToolSchema[], extensions?: Record<string, unknown>): Promise<ProviderMessage>;
     stream(context: RenderedContext, tools: ToolSchema[], extensions?: Record<string, unknown>, state?: ProviderRunState, 
     /** #2-B-ii: when provided, a preempting `InterruptNow` (or `interrupt()`) aborts the in-flight
      *  request. SDK-client providers should forward it to the client (`{ signal }`); the runner also
@@ -564,14 +573,14 @@ export interface LLMProvider {
  * Produces a richer LLM-generated summary that replaces the rule-based one on next wake.
  */
 export interface AsyncSummarizer {
-    summarize(archived: Message[], action: string): Promise<string>;
+    summarize(archived: ProviderMessage[], action: string): Promise<string>;
 }
 /**
  * Durable-memory summarizer for semantic `page_out` events (Layer 5 contract).
  * The kernel emits `page_out { tier_hint: "semantic" }`; the SDK persists an LLM summary to MemoryStore.
  */
 export interface MemorySummarizer {
-    summarize(archived: Message[], context: {
+    summarize(archived: ProviderMessage[], context: {
         action?: string;
     }): Promise<string>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/sdk",
-  "version": "0.2.68",
+  "version": "0.2.70",
   "description": "DeepStrike Node.js SDK",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -73,7 +73,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.99.0",
-    "@deepstrike/core": "0.2.68",
+    "@deepstrike/core": "0.2.70",
     "@google/generative-ai": "^0.24.1",
     "openai": "^7.5.0"
   },