extrait 0.6.1 → 0.7.0

package/README.md

@@ -71,6 +71,7 @@ These examples cover the most common usage patterns in the repository.
 - [`examples/generate.ts`](examples/generate.ts) - High-level text generation
 - [`examples/streaming.ts`](examples/streaming.ts) - Real-time partial output and snapshot updates
 - [`examples/calculator-tool.ts`](examples/calculator-tool.ts) - Structured extraction with MCP tools
+- [`examples/streaming-turns-with-tools.ts`](examples/streaming-turns-with-tools.ts) - Streaming MCP turns, transitions, and reasoning blocks
 - [`examples/conversation.ts`](examples/conversation.ts) - Multi-turn prompts and multimodal content
 - [`examples/image-analysis.ts`](examples/image-analysis.ts) - Vision input with structured output
 - [`examples/embeddings.ts`](examples/embeddings.ts) - Embeddings and similarity workflows
@@ -345,7 +346,7 @@ const result = await llm.generate(
       maxTokens: 800,
       reasoningEffort: "medium",
       mcpClients: [calculatorMCP],
-      maxToolRounds: 8,
+      maxToolRounds: 10,
     },
   }
 );
@@ -695,6 +696,7 @@ Available examples:
 - `generate` - High-level text generation ([generate.ts](examples/generate.ts))
 - `streaming` - Real LLM streaming + snapshot self-check ([streaming.ts](examples/streaming.ts))
 - `streaming-with-tools` - Real text streaming with MCP tools + self-check ([streaming-with-tools.ts](examples/streaming-with-tools.ts))
+- `streaming-turns-with-tools` - Streaming MCP turns, transitions, and reasoning blocks ([streaming-turns-with-tools.ts](examples/streaming-turns-with-tools.ts))
 - `abort-signal` - Start a generation then cancel quickly with `AbortSignal` ([abort-signal.ts](examples/abort-signal.ts))
 - `timeout` - Set per-request and per-tool timeouts via the `timeout` option ([timeout.ts](examples/timeout.ts))
 - `simple` - Basic structured output with streaming ([simple.ts](examples/simple.ts))

package/dist/generate-shared.d.ts

@@ -1,4 +1,4 @@
-import type { LLMAdapter, LLMMessage, LLMRequest, LLMUsage, MCPToolClient, StructuredDebugOptions, StructuredPromptBuilder, StructuredPromptContext, StructuredPromptPayload, StructuredPromptValue, StructuredTimeoutOptions, ThinkBlock } from "./types";
+import type { LLMAdapter, LLMMessage, LLMRequest, LLMToolCall, LLMUsage, MCPToolClient, ReasoningBlock, StreamTurnTransition, StructuredDebugOptions, StructuredPromptBuilder, StructuredPromptContext, StructuredPromptPayload, StructuredPromptValue, StructuredTimeoutOptions, ThinkBlock } from "./types";
 export type PromptRequestOptions = Omit<LLMRequest, "prompt" | "systemPrompt" | "messages">;
 export interface StreamDelta {
     text: string;
@@ -12,7 +12,10 @@ export interface NormalizedStreamConfig<TSnapshot> {
         done: boolean;
         usage?: LLMUsage;
         finishReason?: string;
+        turnIndex?: number;
+        toolCalls?: LLMToolCall[];
     }) => void;
+    onTurnTransition?: (transition: StreamTurnTransition) => void;
     to?: "stdout";
 }
 export interface NormalizedDebugConfig {
@@ -24,6 +27,7 @@ export interface NormalizedDebugConfig {
 export interface NormalizedModelOutput {
     text: string;
     reasoning: string;
+    reasoningBlocks?: ReasoningBlock[];
     thinkBlocks: ThinkBlock[];
     parseSource: string;
 }
@@ -55,6 +59,7 @@ export interface ModelCallResult {
     via: "complete" | "stream";
     usage?: LLMUsage;
     finishReason?: string;
+    reasoningBlocks?: ReasoningBlock[];
 }
 export declare function resolvePrompt(prompt: StructuredPromptBuilder, context: StructuredPromptContext): StructuredPromptPayload;
 export declare function normalizePromptValue(value: StructuredPromptValue, _context: StructuredPromptContext): StructuredPromptPayload;
@@ -65,13 +70,14 @@ export declare function mergeSystemPrompts(primary?: string, secondary?: string)
 export declare function normalizeStreamConfig<TSnapshot>(option: boolean | {
     enabled?: boolean;
     onData?: NormalizedStreamConfig<TSnapshot>["onData"];
+    onTurnTransition?: NormalizedStreamConfig<TSnapshot>["onTurnTransition"];
     to?: "stdout";
 } | undefined): NormalizedStreamConfig<TSnapshot>;
 export declare function normalizeDebugConfig(option: StructuredDebugOptions | boolean | undefined): NormalizedDebugConfig;
 export declare function withToolTimeout(client: MCPToolClient, toolTimeoutMs: number): MCPToolClient;
 export declare function applyToolTimeout(clients: MCPToolClient[], toolTimeoutMs: number): MCPToolClient[];
 export declare function callModel<TSnapshot, TTraceEvent>(adapter: LLMAdapter, options: ModelCallOptions<TSnapshot, TTraceEvent>): Promise<ModelCallResult>;
-export declare function normalizeModelOutput(text: string, dedicatedReasoning?: string): NormalizedModelOutput;
+export declare function normalizeModelOutput(text: string, dedicatedReasoning?: string, reasoningBlocks?: ReasoningBlock[]): NormalizedModelOutput;
 export declare function composeParseSource(text: string, reasoning?: string): string;
 export declare function aggregateUsage<T extends {
     usage?: LLMUsage;