extrait 0.7.0 → 0.7.2

package/README.md

@@ -658,6 +658,8 @@ type MCPCallToolParams = {
 };
 ```
 
+MCP toolsets may change between tool rounds. Providers call `listTools()` before each round, so a client can expose additional tools after a previous `callTool()` result, or remove tools that are no longer available.
+
 Use `transformToolCallParams()` when you need to attach MCP-specific metadata, override the final remote tool name, or otherwise change the full request passed to `client.callTool()`. This hook is exported as `LLMToolCallParamsTransformer`.
 
 ### Timeouts

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, LLMToolCall, LLMUsage, MCPToolClient, ReasoningBlock, StreamTurnTransition, 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;
@@ -74,12 +74,8 @@ export declare function normalizeStreamConfig<TSnapshot>(option: boolean | {
     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, reasoningBlocks?: ReasoningBlock[]): 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[];