extrait 0.6.1 → 0.7.1

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/extract-parse-hint.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionParseHint } from "./types";
+export declare function buildParseHint(content: string, allowRepair: boolean, hintMaxLength: number): ExtractionParseHint | null;
+export declare function parseHintBonus(hint: ExtractionParseHint): number;

package/dist/extract-shape.d.ts

@@ -0,0 +1,21 @@
+import type { ExtractionCandidate, ExtractionHeuristicsOptions } from "./types";
+export interface RankedCandidate extends ExtractionCandidate {
+    shapeScore: number;
+}
+export declare function looksLikeJsonEnvelope(content: string, acceptArrays: boolean): boolean;
+export declare function languageBonus(language: string | null): number;
+export declare function jsonShapeScore(content: string, acceptArrays: boolean): number;
+export declare function boundaryScore(input: string, start: number, end: number): number;
+export declare function lengthScore(length: number): number;
+export declare function passesShapeFilter(candidate: RankedCandidate): boolean;
+export declare function sortCandidates<T extends {
+    score: number;
+    start: number;
+    end: number;
+}>(candidates: T[]): T[];
+export declare function dedupeCandidates<T extends {
+    content: string;
+}>(candidates: T[]): T[];
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function normalizeInteger(value: unknown, fallback: number): number;
+export declare function resolveExtractionHeuristics(input: Partial<ExtractionHeuristicsOptions> | undefined, defaults: ExtractionHeuristicsOptions): ExtractionHeuristicsOptions;

package/dist/generate-debug.d.ts

@@ -0,0 +1,26 @@
+import type { LLMRequest, LLMUsage } from "./types";
+import type { NormalizedDebugConfig } from "./generate-shared";
+export interface DebugRequestInput {
+    label: string;
+    provider?: string;
+    model?: string;
+    attempt: number;
+    selfHealAttempt: boolean;
+    selfHealEnabled: boolean;
+    stream: boolean;
+    requestPayload: LLMRequest;
+}
+export interface DebugResponseInput {
+    label: string;
+    attempt: number;
+    selfHealAttempt: boolean;
+    selfHealEnabled: boolean;
+    via: "complete" | "stream";
+    text: string;
+    reasoning: string;
+    parseSource: string;
+    usage?: LLMUsage;
+    finishReason?: string;
+}
+export declare function emitDebugRequest(config: NormalizedDebugConfig, input: DebugRequestInput): void;
+export declare function emitDebugResponse(config: NormalizedDebugConfig, input: DebugResponseInput): void;

package/dist/generate-model-call.d.ts

@@ -0,0 +1,3 @@
+import type { LLMAdapter } from "./types";
+import type { ModelCallOptions, ModelCallResult } from "./generate-shared";
+export declare function callModel<TSnapshot, TTraceEvent>(adapter: LLMAdapter, options: ModelCallOptions<TSnapshot, TTraceEvent>): Promise<ModelCallResult>;

package/dist/generate-output.d.ts

@@ -0,0 +1,10 @@
+import type { LLMUsage, ReasoningBlock, StreamTurnTransition } from "./types";
+import type { NormalizedModelOutput } from "./generate-shared";
+export declare function normalizeModelOutput(text: string, dedicatedReasoning?: string, reasoningBlocks?: ReasoningBlock[]): NormalizedModelOutput;
+export declare function appendReasoningBlock(blocks: ReasoningBlock[] | undefined, transition: StreamTurnTransition): ReasoningBlock[] | undefined;
+export declare function composeParseSource(text: string, reasoning?: string): string;
+export declare function aggregateUsage<T extends {
+    usage?: LLMUsage;
+}>(attempts: T[]): LLMUsage | undefined;
+export declare function mergeUsage(base: LLMUsage | undefined, next: LLMUsage | undefined): LLMUsage | undefined;
+export declare function toStreamDataFingerprint(value: unknown): string;

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 { LLMMessage, LLMRequest, LLMToolCall, LLMUsage, 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,15 +70,12 @@ 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 composeParseSource(text: string, reasoning?: string): string;
-export declare function aggregateUsage<T extends {
-    usage?: LLMUsage;
-}>(attempts: T[]): LLMUsage | undefined;
-export declare function mergeUsage(base: LLMUsage | undefined, next: LLMUsage | undefined): LLMUsage | undefined;
+export { withToolTimeout, applyToolTimeout } from "./generate-tool-timeout";
+export { callModel } from "./generate-model-call";
+export { aggregateUsage, appendReasoningBlock, composeParseSource, mergeUsage, normalizeModelOutput, toStreamDataFingerprint, } from "./generate-output";
+export type { DebugRequestInput, DebugResponseInput } from "./generate-debug";
+export { emitDebugRequest, emitDebugResponse } from "./generate-debug";

package/dist/generate-tool-timeout.d.ts

@@ -0,0 +1,3 @@
+import type { MCPToolClient } from "./types";
+export declare function withToolTimeout(client: MCPToolClient, toolTimeoutMs: number): MCPToolClient;
+export declare function applyToolTimeout(clients: MCPToolClient[], toolTimeoutMs: number): MCPToolClient[];