@cognipeer/agent-sdk 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import { ZodError, ZodSchema, z, ZodTypeAny } from 'zod';
 import { JSONSchema7 } from 'json-schema';
+import { P as ProviderType, M as ModelRuleLearnedEvent, E as EmbeddingRequest, a as EmbeddingResponse, C as ChatCompletionRequest, b as ChatCompletionResponse, c as ChatCompletionChunk, J as JevProviderConfig, O as OpenAICompatibleProviderConfig, d as OpenAIProviderConfig, R as RulePatch, U as UnifiedMessage, T as ToolDefinition, e as TokenUsage, A as AnthropicProviderConfig, f as AzureProviderConfig, B as BedrockProviderConfig, V as VertexProviderConfig, g as ReasoningRequestConfig, h as ProviderConfig, i as ProviderError } from './model-rules-Bg9nSqyN.cjs';
+export { a4 as AudioContent, I as EffortMapping, a0 as EmbeddingInputType, $ as EmbeddingUsage, a3 as FileContent, Z as FinishReason, a2 as ImageContent, v as MAX_ADJUSTMENTS, k as MODEL_RULES, W as MaxTokensParam, D as ModelRule, F as ModelRules, Q as OffMechanism, Y as ParsedModelError, _ as ProviderResponseFields, a5 as ProviderToolCall, a6 as ProviderTransportConfig, H as ReasoningEffort, N as ReasoningStyle, G as ResolvedModelRule, K as RuleFamily, L as RuleSource, X as SamplingField, S as TemperatureRule, a1 as TextContent, n as allowsSampling, o as applyDropParams, u as asModelRequestError, z as clearLearnedModelRules, p as effortBudget, j as emptyUsage, x as getLearnedModelRulePatch, w as listLearnedModelRules, m as mapReasoningEffort, q as mergeRulePatch, l as modelIdCandidates, s as parseModelError, y as rememberModelRulePatch, r as resolveModelRule, t as runWithModelAdjustments } from './model-rules-Bg9nSqyN.cjs';
 
 /** Describes what a model/provider natively supports. */
 type ModelCapabilities = {
@@ -242,7 +244,7 @@ declare function describeContentPart(part: unknown): string | undefined;
  * `content`, else its JSON).
  */
 declare function contentPartToText(part: unknown, fallback?: (part: unknown) => string): string;
-declare function contentToString(content: string | ContentPart$1[] | any): string;
+declare function contentToString(content: string | ContentPart[] | any): string;
 declare function extractMessageText(message: any): string;
 /**
  * The text a hook should reason about: the text parts only, joined.
@@ -252,7 +254,7 @@ declare function extractMessageText(message: any): string;
  * that string would be scoring the SDK's own placeholder text, and a redactor
  * rewriting it would bake the placeholder into the message.
  */
-declare function textFromContent(content: string | ContentPart$1[] | unknown): string;
+declare function textFromContent(content: string | ContentPart[] | unknown): string;
 /**
  * Rewrite the text of a message's content, leaving every other part exactly as
  * it was — same objects, same order.
@@ -261,7 +263,7 @@ declare function textFromContent(content: string | ContentPart$1[] | unknown): s
  * string over a multi-part `content` is the silent version of this operation:
  * the run still answers, it just answers without the image the user attached.
  */
-declare function mapTextParts(content: string | ContentPart$1[] | unknown, fn: (text: string) => string): string | ContentPart$1[] | unknown;
+declare function mapTextParts(content: string | ContentPart[] | unknown, fn: (text: string) => string): string | ContentPart[] | unknown;
 /**
  * Put a whole replacement text back into a multi-part content.
  *
@@ -272,9 +274,9 @@ declare function mapTextParts(content: string | ContentPart$1[] | unknown, fn: (
  * plugin that needs exact multi-part fidelity should return `content` instead,
  * which is why that field exists.
  */
-declare function replaceTextContent(content: string | ContentPart$1[] | unknown, text: string): string | ContentPart$1[] | unknown;
+declare function replaceTextContent(content: string | ContentPart[] | unknown, text: string): string | ContentPart[] | unknown;
 /** Every non-text part of a message, normalized for policy code. */
-declare function collectAttachments(content: string | ContentPart$1[] | unknown): MediaAttachment[];
+declare function collectAttachments(content: string | ContentPart[] | unknown): MediaAttachment[];
 
 /**
  * Plugin layer — type surface.
@@ -382,7 +384,7 @@ interface HookMap {
             /** Concatenated text parts. Empty string for a media-only turn. */
             text: string;
             /** The full content, string or parts. Return `content` to rewrite it exactly. */
-            content: string | ContentPart$1[];
+            content: string | ContentPart[];
             /** Every non-text part, normalized across the unified and legacy shapes. */
             attachments: MediaAttachment[];
             message: Message;
@@ -398,7 +400,7 @@ interface HookMap {
              */
             text?: string;
             /** Full control over the parts: reorder, drop an attachment, rewrite per part. */
-            content?: string | ContentPart$1[];
+            content?: string | ContentPart[];
             /** Extra system-level context appended for this turn only. */
             additionalContext?: string;
             decision?: "allow" | "deny";
@@ -1128,7 +1130,7 @@ type ImageURL = {
     media_type?: string;
     detail?: 'auto' | 'low' | 'high';
 } | string;
-type ContentPart$1 = {
+type ContentPart = {
     type: 'text';
     text: string;
 } | {
@@ -1188,7 +1190,7 @@ type RunnableConfig = {
 type BaseMessage = {
     role: string;
     name?: string;
-    content: string | ContentPart$1[];
+    content: string | ContentPart[];
     tool_calls?: any;
     tool_call_id?: string;
     [key: string]: any;
@@ -1467,7 +1469,7 @@ type ReflectionConfig = {
 };
 type NativeReasoningConfig = {
     /** `none` is OFF — a value that gets SENT. See ReasoningEffort in providers/types.ts. */
-    effort?: "none" | "minimal" | "low" | "medium" | "high";
+    effort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
     budgetTokens?: number;
     includeThoughts?: boolean;
     providerExtras?: Record<string, any>;
@@ -2014,7 +2016,12 @@ type TraceEventRecord = {
         role?: string;
         version?: string;
     };
-    status: "success" | "error" | "skipped" | "retry";
+    /**
+     * `pending`: a step that is waiting on someone outside the run — a tool
+     * approval or a question to the user that was asked when the run paused.
+     * The answer is recorded as a separate event when the run resumes.
+     */
+    status: "success" | "error" | "skipped" | "retry" | "pending";
     durationMs?: number;
     inputTokens?: number;
     outputTokens?: number;
@@ -2067,7 +2074,36 @@ type TraceSessionSummary = {
     totalBytesOut: number;
     eventCounts: Record<string, number>;
 };
-type TraceSessionStatus = "in_progress" | "success" | "error" | "partial";
+/**
+ * `paused`: the run stopped to wait for a tool approval or an answer from the
+ * user. Its trace continues — same session id, the next sequence numbers — in
+ * the invoke that resumes it (see `TraceContinuation`).
+ * `in_progress` on a finalized session: an internal leg of a longer turn
+ * (the smart agent's summarization bounce) whose next leg continues it.
+ */
+type TraceSessionStatus = "in_progress" | "success" | "error" | "partial" | "paused";
+/**
+ * Where a paused (or mid-turn) trace session left off, carried on the
+ * returned state as `ctx.__traceContinuation` so the invoke that resumes the
+ * run records into the SAME session instead of opening a new one. Plain JSON:
+ * it survives snapshots and a caller's own persistence of the paused state.
+ */
+type TraceContinuation = {
+    v: 1;
+    sessionId: string;
+    traceId?: string;
+    rootSpanId?: string;
+    threadId?: string;
+    /** Epoch ms of the session's first part. */
+    startedAt: number;
+    /** Sequence number the next event takes. */
+    nextSequence: number;
+    /** 1-based number of the part that just ended. */
+    part: number;
+    /** Totals so far — a continued session reports cumulative totals. */
+    summary: TraceSessionSummary;
+    errors: TraceErrorRecord[];
+};
 type TraceSinkSnapshot = {
     type: "file";
     path: string;
@@ -2109,6 +2145,17 @@ type TraceSessionFile = {
     events: TraceEventRecord[];
     status: TraceSessionStatus;
     errors: TraceErrorRecord[];
+    /**
+     * Present when this payload continues a session an earlier invoke started
+     * (a run resumed after a pause): `events` holds only this part's events,
+     * numbered from `firstSequence`, while `summary`, `startedAt` and `errors`
+     * cover the whole session. A sink should APPEND these events to the ones it
+     * already has for `sessionId`, not replace them.
+     */
+    continuation?: {
+        part: number;
+        firstSequence: number;
+    };
 };
 type ResolvedTraceSink = {
     type: "file";
@@ -2159,6 +2206,10 @@ type TraceSessionRuntime = {
     summary: TraceSessionSummary;
     status: TraceSessionStatus;
     errors: TraceErrorRecord[];
+    /** Events recorded by earlier parts of this session (see `TraceContinuation`). */
+    sequenceOffset?: number;
+    /** 1-based part number; 1 for a session that starts with this invoke. */
+    part?: number;
     fileBaseDir?: string;
     fileSessionDir?: string;
 };
@@ -3308,496 +3359,6 @@ type CreateGuardrailOptions = {
 };
 declare function createGuardrail(options: CreateGuardrailOptions): ConversationGuardrail;
 
-type MessageRole = "system" | "user" | "assistant" | "tool";
-type TextContent = {
-    type: "text";
-    text: string;
-};
-type ImageContent = {
-    type: "image";
-    source: {
-        type: "base64";
-        mediaType: string;
-        data: string;
-    } | {
-        type: "url";
-        url: string;
-        mediaType?: string;
-    };
-};
-/**
- * A document attachment (PDF, DOCX, CSV, …). Providers map this to their
- * native document blocks: Gemini `inlineData`/`fileData`, Anthropic
- * `document`, OpenAI Chat Completions `file` / Responses `input_file`,
- * Bedrock Converse `document`. Providers without document support degrade
- * to a text placeholder referencing the file name/URL.
- */
-type FileContent = {
-    type: "file";
-    source: {
-        type: "base64";
-        mediaType: string;
-        data: string;
-    } | {
-        type: "url";
-        url: string;
-        mediaType?: string;
-    };
-    /** Original file name, when known (required by some providers, e.g. Bedrock). */
-    fileName?: string;
-};
-/**
- * An audio attachment. Gemini accepts it as `inlineData`/`fileData`; OpenAI
- * audio-capable models as `input_audio`. Providers without audio support
- * degrade to a text placeholder.
- */
-type AudioContent = {
-    type: "audio";
-    source: {
-        type: "base64";
-        mediaType: string;
-        data: string;
-    } | {
-        type: "url";
-        url: string;
-        mediaType?: string;
-    };
-};
-type ContentPart = TextContent | ImageContent | FileContent | AudioContent;
-type ToolCall = {
-    id: string;
-    name: string;
-    arguments: string;
-    /** Gemini `thoughtSignature` attached to a functionCall part; must be echoed back on the next turn. */
-    thoughtSignature?: string;
-    /** Position of the call within the assistant turn. Set on streamed deltas so a consumer can frame them (OpenAI `tool_calls[].index`). */
-    index?: number;
-};
-/**
- * A provider-native reasoning/thinking block. Captured from the model response
- * and replayed verbatim on subsequent turns (required by Anthropic extended
- * thinking when tools are involved — the `signature` must round-trip intact).
- */
-type ReasoningBlock = {
-    type: "thinking" | "redacted_thinking";
-    /** Plain-text thinking content (absent for redacted blocks). */
-    text?: string;
-    /** Cryptographic signature Anthropic requires to be echoed back verbatim. */
-    signature?: string;
-    /** Opaque payload for redacted_thinking blocks. */
-    data?: string;
-};
-/** Captured reasoning payload attached to assistant turns / responses. */
-type ReasoningPayload = {
-    /** Verbatim provider blocks to replay on the next turn. */
-    blocks?: ReasoningBlock[];
-    /** Human-readable reasoning summary, when the provider exposes one. */
-    summary?: string;
-};
-type UnifiedMessage = {
-    role: MessageRole;
-    content: string | ContentPart[];
-    name?: string;
-    toolCalls?: ToolCall[];
-    toolCallId?: string;
-    /** Native reasoning blocks to replay verbatim (Anthropic/Bedrock thinking). */
-    reasoning?: ReasoningPayload;
-};
-type ToolDefinition = {
-    name: string;
-    description: string;
-    parameters: Record<string, any>;
-    strict?: boolean;
-};
-type ChatCompletionRequest = {
-    model: string;
-    messages: UnifiedMessage[];
-    temperature?: number;
-    maxTokens?: number;
-    topP?: number;
-    stop?: string[];
-    /** OpenAI-family only; other providers ignore it. */
-    presencePenalty?: number;
-    /** OpenAI-family only; other providers ignore it. */
-    frequencyPenalty?: number;
-    tools?: ToolDefinition[];
-    toolChoice?: "auto" | "required" | "none" | {
-        name: string;
-    };
-    responseFormat?: {
-        type: "json_schema" | "json_object" | "text";
-        schema?: Record<string, any>;
-        name?: string;
-    };
-    stream?: boolean;
-    /**
-     * Streaming only. `false` opts out of `stream_options.include_usage` on
-     * OpenAI-shaped endpoints (some servers reject the option). Default true.
-     */
-    streamUsage?: boolean;
-    /** OpenAI-family: deterministic sampling seed. Passed through. */
-    seed?: number;
-    /** OpenAI-family: number of choices. Pass-through only; only choice 0 is parsed. */
-    n?: number;
-    /** OpenAI-family: allow/forbid parallel tool calls. Passed through when set. */
-    parallelToolCalls?: boolean;
-    /** OpenAI-family: return token log probabilities. Passed through. */
-    logprobs?: boolean;
-    /** OpenAI-family: how many top log probabilities per token. Passed through. */
-    topLogprobs?: number;
-    extra?: Record<string, any>;
-    /**
-     * Unified native-reasoning request config. Each provider maps this to its
-     * own shape:
-     *  - OpenAI o-series:   body.reasoning_effort = effort
-     *  - OpenAI Responses:  body.reasoning = { effort }
-     *  - Anthropic:         body.thinking  = { type: "enabled", budget_tokens }
-     *  - Google / Vertex:   body.generationConfig.thinkingConfig = { thinkingBudget, includeThoughts }
-     *
-     * Providers silently ignore unsupported fields.
-     */
-    reasoning?: ReasoningRequestConfig;
-    /**
-     * Cancels the HTTP request (and an in-flight stream) when it aborts. The agent
-     * loop sets it from the run's cancellation token / abort signal; a caller using
-     * a provider directly can pass its own. It is never serialised into the body.
-     */
-    signal?: AbortSignal;
-};
-/**
- * `none` is OFF, and it is a value rather than the absence of one.
- *
- * On a thinking-by-default model — every Qwen3 under vLLM, gpt-5.1 and newer on
- * OpenAI — sending no reasoning field leaves the model thinking. So "do not
- * think" is an instruction that has to travel: `reasoning_effort:"none"` on
- * OpenAI, `thinkingBudget:0` on Gemini, and no thinking block at all on
- * Anthropic (where thinking is opt-in and the absence IS off). Omitting
- * `effort` still means "say nothing about reasoning", which is the different
- * and equally necessary state.
- */
-type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high";
-type ReasoningRequestConfig = {
-    /** Qualitative effort hint (mapped per-provider). */
-    effort?: ReasoningEffort;
-    /** Explicit per-call token budget for reasoning/thinking. */
-    budgetTokens?: number;
-    /**
-     * Gemini 3 style discrete thinking level (e.g. "low" | "high"). Sent as
-     * `thinkingConfig.thinkingLevel` and replaces the derived `thinkingBudget`
-     * (the API rejects both together). Ignored by other providers.
-     */
-    thinkingLevel?: string;
-    /** Whether the provider should expose its reasoning/thought summary to the caller. Gemini: default false. Claude adaptive thinking (5.x): default summarized (`thinking.display = "summarized"`) unless this is `false`; never added when the caller passes an explicit `extra.thinking`. */
-    includeThoughts?: boolean;
-    /** Provider-specific passthrough merged on top of the mapped shape. */
-    providerExtras?: Record<string, any>;
-};
-type TokenUsage = {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    cachedInputTokens: number;
-    cachedWriteTokens: number;
-    cachedOutputTokens: number;
-    reasoningTokens: number;
-};
-declare function emptyUsage(): TokenUsage;
-type FinishReason = "stop" | "tool_calls" | "length" | "content_filter" | "error";
-type ProviderResponseFields = {
-    system_fingerprint?: string;
-    service_tier?: string;
-    annotations?: any[];
-    refusal?: string | null;
-    logprobs?: any;
-    [key: string]: any;
-};
-type ChatCompletionResponse = {
-    id: string;
-    model: string;
-    content: string | null;
-    toolCalls: ToolCall[];
-    usage: TokenUsage;
-    finishReason: FinishReason;
-    /** The provider's own finish/stop reason string, unnormalised (e.g. "end_turn", "function_call"). */
-    rawFinishReason?: string;
-    /**
-     * Provider response fields the unified shape has no slot for, kept when present:
-     * `system_fingerprint`, `service_tier`, `annotations`, `refusal`, `logprobs`.
-     */
-    providerFields?: ProviderResponseFields;
-    /** Native reasoning blocks + summary captured from the response, if any. */
-    reasoning?: ReasoningPayload;
-    raw: any;
-};
-type ChatCompletionChunk = {
-    id: string;
-    model: string;
-    delta: {
-        content?: string;
-        toolCalls?: Partial<ToolCall>[];
-        /** Incremental reasoning text / signature deltas (Anthropic thinking). */
-        reasoning?: ReasoningPayload;
-    };
-    usage?: TokenUsage;
-    finishReason?: FinishReason;
-    /** The provider's own finish reason string, unnormalised. Present on the chunk that carries it. */
-    rawFinishReason?: string;
-    /** See ChatCompletionResponse.providerFields; per-chunk (fingerprint, tier, delta refusal/annotations, logprobs). */
-    providerFields?: ProviderResponseFields;
-};
-/** Why the text is being embedded; mapped to each provider's own task/input type. */
-type EmbeddingInputType = "search_document" | "search_query" | "classification" | "clustering" | "semantic_similarity" | "question_answering" | "fact_verification" | "code_retrieval_query" | (string & {});
-type EmbeddingRequest = {
-    /** Model id (OpenAI/compatible), deployment name (Azure), model id (Bedrock), model name (Vertex). */
-    model: string;
-    /** Texts to embed. One vector per entry, in the same order. */
-    input: string[];
-    /** Requested output dimensions, for models that support shortening (OpenAI v3, Titan v2, Cohere v4, Gemini). */
-    dimensions?: number;
-    /** OpenAI-shaped endpoints: wire encoding. Vectors are always returned as number[] either way. */
-    encodingFormat?: "float" | "base64";
-    /** Task hint (Cohere on Bedrock, Gemini on Vertex). Ignored by providers without one. */
-    inputType?: EmbeddingInputType;
-    /** Max texts per HTTP request. Defaults per provider (OpenAI 2048, Vertex 100, Gemini-embedding 1, Titan 1). */
-    batchSize?: number;
-    /** Provider-specific fields merged into each request body (escape hatch). */
-    extra?: Record<string, any>;
-    signal?: AbortSignal;
-};
-type EmbeddingUsage = {
-    inputTokens: number;
-    totalTokens: number;
-};
-type EmbeddingResponse = {
-    model: string;
-    /** One vector per input, in input order. */
-    vectors: number[][];
-    usage: EmbeddingUsage;
-    /** Raw provider responses, one per HTTP request made. */
-    raw: any[];
-};
-type ProviderRetryConfig = {
-    /** Maximum retries on 429/5xx (default 3). */
-    maxRetries?: number;
-    /** Initial delay between retries in ms (default 500, doubled each attempt). */
-    baseDelayMs?: number;
-    /** Hard cap on a single retry delay in ms (default 8000). */
-    maxDelayMs?: number;
-    /** Custom predicate to opt in/out of a specific retry. */
-    shouldRetry?: (error: any, attempt: number) => boolean;
-};
-/** Transport options shared by every provider config. */
-type ProviderTransportConfig = {
-    /**
-     * Custom `fetch` used at EVERY HTTP call site of the provider (chat, stream,
-     * Responses, token exchange). Lets a host inject an SSRF-safe or proxied
-     * fetch. Defaults to the global `fetch`.
-     */
-    fetch?: typeof fetch;
-    /**
-     * Per-request timeout in ms, measured until the response headers arrive
-     * (an established stream is not cut by it). Default: none.
-     */
-    timeoutMs?: number;
-};
-type OpenAIProviderConfig = ProviderTransportConfig & {
-    /**
-     * Which token-limit field to send: `max_tokens` or `max_completion_tokens`.
-     * `auto` (default) uses `max_completion_tokens` for o-series / gpt-5 models
-     * and `max_tokens` otherwise.
-     */
-    maxTokensParam?: "auto" | "max_tokens" | "max_completion_tokens";
-    provider: "openai";
-    apiKey: string;
-    baseURL?: string;
-    organization?: string;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-    retry?: ProviderRetryConfig;
-    /**
-     * @deprecated Use `api: "chat" | "responses" | "auto"`. Kept as an alias:
-     * `never` = chat, `always` = responses, `auto` = the name-based heuristic.
-     * When `api` is also set, `api` wins.
-     *
-     * WHICH API a reasoning-carrying request is addressed to.
-     *
-     *  auto    (the default for OpenAI and Azure) route to the Responses API when
-     *          the request carries `reasoning` AND the model name looks like an
-     *          o-series/gpt-5 reasoning model.
-     *  never   always Chat Completions. `reasoning` is still mapped, as
-     *          `reasoning_effort` plus any `providerExtras`.
-     *  always  always Responses, whatever the model is called.
-     *
-     * `auto` is a name-based guess, and it decides far more than where reasoning
-     * goes: Responses is a different request shape (`input` not `messages`,
-     * `text.format` not `response_format`, flat tool objects) and a different
-     * response parse. A caller with its own measurements of the Chat Completions
-     * body — a gateway, a proxy, an on-prem server that serves one and not the
-     * other, or anything that has tuned `extra` — must be able to say so, rather
-     * than discover that asking for less thinking silently changed the transport.
-     *
-     * Applies to any OpenAI-shaped endpoint, which is also why the guess is weak
-     * where it matters most: a self-hosted model is named by whoever served it.
-     */
-    responsesApi?: "auto" | "never" | "always";
-    /** @internal Set by OpenAICompatibleProvider: `auto` then means Chat Completions. */
-    _autoMeansChat?: boolean;
-    /**
-     * Which upstream API requests are sent to. `"auto"` (default) keeps the
-     * 0.11 behaviour of each class: OpenAI and Azure use Responses when the
-     * request carries `reasoning` and the model name looks like an o-series /
-     * gpt-5 model, otherwise Chat Completions; OpenAI-compatible always uses
-     * Chat Completions (the model name is the server operator's). `"chat"` always
-     * sends Chat Completions. `"responses"`
-     * sends every request to the Responses API (`POST /responses`) and streams it
-     * over real SSE (text, tool-call arguments and reasoning-summary deltas;
-     * set `responsesStreaming: false` to get one non-streaming call instead).
-     * Works on `OpenAIProvider`, `AzureProvider` and `OpenAICompatibleProvider`.
-     * When set, it wins over the deprecated `responsesApi`.
-     */
-    api?: "chat" | "responses" | "auto";
-    /**
-     * Models that go to the Responses API, named explicitly. Opt-in; unset by
-     * default.
-     *
-     * A string matches the request's model (or `defaultModel`) exactly; a RegExp
-     * is tested against it. A match routes the request to Responses whether or
-     * not it carries `reasoning` — the case this exists for is a model that
-     * reasons by default and rejects function tools on Chat Completions, where
-     * sending no reasoning field does not help. `responsesApi: "never"` still
-     * wins; under `"always"` the routing is unchanged.
-     *
-     * Requests for a matched model also get, on the Responses body only:
-     *  - Chat Completions spellings arriving through `extra`, which /responses
-     *    rejects with a 400, re-spelled with their values unchanged:
-     *    `reasoning_effort` → `reasoning.effort` (a request `reasoning` effort
-     *    still wins), `max_tokens` / `max_completion_tokens` →
-     *    `max_output_tokens`, `response_format` → `text.format`, and
-     *    `stream_options.include_usage` dropped.
-     *  - real SSE streaming, when `responsesStreaming` is also true.
-     *
-     * Honoured by `OpenAIProvider`, `AzureProvider` and
-     * `OpenAICompatibleProvider` alike.
-     */
-    responsesApiModels?: Array<string | RegExp>;
-    /**
-     * Stream Responses API output as it arrives (text, tool-call argument and
-     * reasoning-summary deltas) for `api: "responses"` and for models in
-     * `responsesApiModels`. Default true with `api: "responses"`, false
-     * otherwise (one non-streaming Responses call emitted as a single chunk).
-     * Has no effect on Chat Completions requests.
-     */
-    responsesStreaming?: boolean;
-};
-type AnthropicProviderConfig = ProviderTransportConfig & {
-    provider: "anthropic";
-    apiKey: string;
-    baseURL?: string;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-    anthropicVersion?: string;
-    retry?: ProviderRetryConfig;
-    /**
-     * Prompt caching configuration. When enabled, places cache_control:
-     * ephemeral breakpoints on the system prompt and the final tool definition,
-     * which is the recommended Anthropic recipe for static system + tools.
-     */
-    prompt_caching?: {
-        enabled: boolean;
-    };
-    /**
-     * Thinking request shape. `auto` (default) picks per model id: Claude 5.x
-     * and newer use `thinking:{type:"adaptive"}` + `output_config.effort`, older
-     * models use `thinking:{type:"enabled", budget_tokens}`. Force one with
-     * `adaptive` / `budget`. On the specific 400 for the wrong shape the
-     * provider retries once with the other form.
-     */
-    thinkingMode?: "auto" | "adaptive" | "budget";
-};
-type AzureProviderConfig = ProviderTransportConfig & {
-    provider: "azure";
-    retry?: ProviderRetryConfig;
-    /** See OpenAIProviderConfig.maxTokensParam. */
-    maxTokensParam?: "auto" | "max_tokens" | "max_completion_tokens";
-    apiKey: string;
-    endpoint: string;
-    apiVersion?: string;
-    deploymentName?: string;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-    /** See OpenAIProviderConfig.api. Default "auto". */
-    api?: "chat" | "responses" | "auto";
-    /** @deprecated Use `api`. */
-    responsesApi?: "auto" | "never" | "always";
-    responsesApiModels?: Array<string | RegExp>;
-    responsesStreaming?: boolean;
-};
-type OpenAICompatibleProviderConfig = ProviderTransportConfig & {
-    provider: "openai-compatible";
-    organization?: string;
-    retry?: ProviderRetryConfig;
-    /** @deprecated Use `api`. Default: see `api`. */
-    responsesApi?: "auto" | "never" | "always";
-    /** See OpenAIProviderConfig.api. Default "auto". */
-    api?: "chat" | "responses" | "auto";
-    responsesApiModels?: Array<string | RegExp>;
-    responsesStreaming?: boolean;
-    /** See OpenAIProviderConfig.maxTokensParam. Compatible servers default to `auto`. */
-    maxTokensParam?: "auto" | "max_tokens" | "max_completion_tokens";
-    apiKey: string;
-    baseURL: string;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-};
-type BedrockProviderConfig = ProviderTransportConfig & {
-    provider: "bedrock";
-    region: string;
-    /** Thinking request shape for Claude models: `auto` (by model id), `adaptive` or `budget`. */
-    thinkingMode?: "auto" | "adaptive" | "budget";
-    accessKeyId?: string;
-    secretAccessKey?: string;
-    sessionToken?: string;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-    retry?: ProviderRetryConfig;
-    /**
-     * Insert Bedrock Converse `cachePoint` blocks at the end of the system
-     * prompt and tools list. Only supported by models that implement Converse
-     * prompt caching (most Anthropic Claude variants on Bedrock).
-     */
-    prompt_caching?: {
-        enabled: boolean;
-    };
-};
-type VertexProviderConfig = ProviderTransportConfig & {
-    provider: "vertex";
-    projectId: string;
-    location?: string;
-    accessToken?: string;
-    serviceAccountJson?: string | Record<string, any>;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-    /** Retry policy for 429/5xx (default 3 retries, exponential backoff). */
-    retry?: ProviderRetryConfig;
-};
-type JevProviderConfig = ProviderTransportConfig & {
-    provider: "jev";
-    apiKey: string;
-    /** Defaults to https://api.typesafe.ai. */
-    baseURL?: string;
-    defaultModel?: string;
-    defaultHeaders?: Record<string, string>;
-    retry?: ProviderRetryConfig;
-};
-type ProviderConfig = OpenAIProviderConfig | AnthropicProviderConfig | AzureProviderConfig | OpenAICompatibleProviderConfig | BedrockProviderConfig | VertexProviderConfig | JevProviderConfig;
-type ProviderType = ProviderConfig["provider"];
-declare class ProviderError extends Error {
-    readonly provider: string;
-    readonly statusCode?: number | undefined;
-    readonly responseBody?: any | undefined;
-    constructor(message: string, provider: string, statusCode?: number | undefined, responseBody?: any | undefined);
-}
-
 type ProviderRetryPolicy = {
     /** Maximum number of retries on 429/5xx responses. Default: 3. */
     maxRetries?: number;
@@ -3818,10 +3379,13 @@ declare abstract class BaseProvider {
     protected fetchImpl?: typeof fetch;
     /** Per-request timeout in ms (config.timeoutMs). Undefined = no timeout. */
     protected timeoutMs?: number;
+    /** Called when a 400 taught the provider a per-model adjustment (config.onModelRuleLearned). */
+    protected onModelRuleLearned?: (event: ModelRuleLearnedEvent) => void;
     /** Applies the transport options shared by every provider config. */
     protected configureTransport(config: {
         fetch?: typeof fetch;
         timeoutMs?: number;
+        onModelRuleLearned?: (event: ModelRuleLearnedEvent) => void;
     }): void;
     /**
      * The single HTTP entry point for every provider call site. Uses the
@@ -5849,13 +5413,20 @@ declare function buildToolDefinitionsSection(toolDefinitions: Array<{
  * Exported for provider/node code that assembles sections itself.
  */
 declare function buildResponseFormatSection(responseFormat: Record<string, any> | undefined, strategy?: "native" | "tool_based"): TraceResponseFormatSection | undefined;
+/**
+ * Reads a `ctx.__traceContinuation` value back, or undefined when it is not
+ * one. It arrives from caller-persisted state, so every field is checked.
+ */
+declare function readTraceContinuation(value: unknown): TraceContinuation | undefined;
+/** Where `session` leaves off, for the invoke that will continue it. */
+declare function traceContinuationOf(session: TraceSessionRuntime): TraceContinuation;
 /**
  * Start a streaming trace session. Should be called before recording events in streaming mode.
  * This sends the session start to the remote endpoint immediately.
  */
 declare function startStreamingSession(session: TraceSessionRuntime | undefined, agentRuntime?: AgentRuntimeConfig): Promise<void>;
 
-/** True for Claude model ids of major version 5+ (or the `fable` line). */
+/** True when the model's rule uses `thinking:{type:"adaptive"}` + `output_config.effort` (Claude 4.6+ / 5.x). */
 declare function supportsAdaptiveThinking(model: unknown): boolean;
 
 declare class OpenAIProvider extends BaseProvider {
@@ -5893,7 +5464,11 @@ declare class OpenAIProvider extends BaseProvider {
     /** POST /embeddings, batched (default 2048 inputs per request, the OpenAI cap). */
     embed(request: EmbeddingRequest): Promise<EmbeddingResponse>;
     protected embeddingsFetch(body: Record<string, any>, signal?: AbortSignal): Promise<Response>;
-    protected buildRequestBody(request: ChatCompletionRequest, stream: boolean): Record<string, any>;
+    /** Chat Completions call that corrects itself from the provider's own 400s (see models/adjust.ts). */
+    private fetchChat;
+    /** Same for the Responses API. */
+    private fetchResponses;
+    protected buildRequestBody(request: ChatCompletionRequest, stream: boolean, overlay?: RulePatch): Record<string, any>;
     protected completeResponses(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
     /** Real Responses SSE streaming, for models opted in through
      * `responsesApiModels` with `responsesStreaming` on. Emits the same chunk
@@ -5903,7 +5478,7 @@ declare class OpenAIProvider extends BaseProvider {
      * (taken from the completed response, exactly as the non-streaming parse
      * reads it). */
     private streamResponses;
-    protected buildResponsesBody(request: ChatCompletionRequest): Record<string, any>;
+    protected buildResponsesBody(request: ChatCompletionRequest, overlay?: RulePatch): Record<string, any>;
     /** Maps a unified message to a Responses API `input` item. */
     protected toResponsesInput(m: UnifiedMessage): Record<string, any>;
     protected responsesFetch(body: Record<string, any>, signal?: AbortSignal): Promise<Response>;
@@ -6148,4 +5723,26 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
  */
 declare function createProvider(config: ProviderConfig): BaseProvider;
 
-export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type ApprovalTransport, type AudioContent, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, type BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type ConversationPluginConfig, type ConversationStore, type CostEstimator, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EmbeddingInputType, type EmbeddingRequest, type EmbeddingResponse, type EmbeddingUsage, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, type FinalAnswerEvent, type FinishReason, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailJudgeEngine, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, type ImageContent, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JevClientLike, type JevEngineOptions, type JevNoulAnswer, JevProvider, type JevProviderConfig, type JevQuestion, type JevSystemOneRequest, type JevSystemOneResult, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind$1 as MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MessageUsage, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, type OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, type ProviderConfig, ProviderError, type ProviderResponseFields, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderTransportConfig, type ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StrictRestorers, type StrictTransform, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessagePart, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentPartToText, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, describeContentPart, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, emptyUsage, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasMediaPart, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaKindOf, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, supportsAdaptiveThinking, textFromContent, toMessageUsage, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
+type ModelRequestErrorCode = "unsupported_parameter" | "unsupported_value" | "model_request_invalid";
+type ModelRequestErrorInit = {
+    status?: number;
+    code: ModelRequestErrorCode;
+    param?: string;
+    value?: unknown;
+    supportedValues?: string[];
+    provider: string;
+    model: string;
+    message: string;
+    responseBody?: unknown;
+};
+declare class ModelRequestError extends ProviderError {
+    readonly status: number;
+    readonly code: ModelRequestErrorCode;
+    readonly param?: string;
+    readonly value?: unknown;
+    readonly supportedValues?: string[];
+    readonly model: string;
+    constructor(init: ModelRequestErrorInit);
+}
+
+export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, AnthropicProviderConfig, type ApprovalTransport, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type ConversationPluginConfig, type ConversationStore, type CostEstimator, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, EmbeddingRequest, EmbeddingResponse, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailJudgeEngine, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JevClientLike, type JevEngineOptions, type JevNoulAnswer, JevProvider, JevProviderConfig, type JevQuestion, type JevSystemOneRequest, type JevSystemOneResult, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind$1 as MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MessageUsage, type MetadataEvent, type ModelCapabilities, ModelRequestError, type ModelRequestErrorCode, type ModelRequestErrorInit, ModelRuleLearnedEvent, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, ProviderConfig, ProviderError, ToolDefinition as ProviderToolDefinition, ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, RulePatch, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StrictRestorers, type StrictTransform, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TokenCounter, TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceContinuation, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessagePart, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentPartToText, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, describeContentPart, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasMediaPart, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaKindOf, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, readTraceContinuation, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, supportsAdaptiveThinking, textFromContent, toMessageUsage, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceContinuationOf, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };