@cognipeer/agent-sdk 0.6.0 → 0.6.2

package/dist/index.d.cts

@@ -254,6 +254,48 @@ type AgentOptions = {
     usageConverter?: (finalMessage: AIMessage, fullState: SmartState, model: any) => any;
     outputSchema?: ZodSchema<any>;
     tracing?: TracingConfig;
+    /**
+     * Unified reasoning configuration. Controls both:
+     * - Provider-native reasoning (OpenAI reasoning_effort, Anthropic thinking, Gemini thinkingConfig)
+     * - Post-turn reflection (a short textual insight from the model after each tool turn)
+     *
+     * When omitted or `enabled=false` the agent behaves exactly as before.
+     */
+    reasoning?: ReasoningConfig;
+};
+type ReasoningLevel = "low" | "medium" | "high";
+type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch";
+type ReflectionConfig = {
+    enabled?: boolean;
+    cadence?: ReflectionCadence;
+    /**
+     * - "piggyback" (default) — appends a short user-style "reflect now" message to the existing
+     *   transcript, reusing provider prompt cache. No tools. Returned text becomes a reflection record.
+     * - "separate" — dedicated tool-free call with a compact prompt (cheaper, smaller cache hit).
+     */
+    mode?: "piggyback" | "separate";
+    maxTokens?: number;
+    maxChars?: number;
+    keepLast?: number;
+    /** When true reflection messages are compressible by the summarizer. Default false. */
+    summarize?: boolean;
+    promptTemplate?: string;
+    /** When true emits `reflection` SmartAgent events. Default true. */
+    emitEvents?: boolean;
+};
+type NativeReasoningConfig = {
+    effort?: "minimal" | "low" | "medium" | "high";
+    budgetTokens?: number;
+    includeThoughts?: boolean;
+    providerExtras?: Record<string, any>;
+};
+type ReasoningConfig = {
+    enabled?: boolean;
+    level?: ReasoningLevel;
+    /** Pass `false` to disable provider-native reasoning while keeping reflection. */
+    native?: NativeReasoningConfig | false;
+    /** Pass `false` to fully disable reflection. */
+    reflection?: ReflectionConfig | false;
 };
 type BuiltInRuntimeProfile = "fast" | "balanced" | "deep" | "research";
 type RuntimeProfile = BuiltInRuntimeProfile | "custom";
@@ -341,8 +383,6 @@ type SmartAgentContextConfig = {
     policy?: ContextPolicy;
     lastTurnsToKeep?: number;
     toolResponsePolicy?: ToolResponseRetentionPolicy;
-    archiveLargeToolResponses?: boolean;
-    retrieveArchivedToolResponseOnDemand?: boolean;
     budget?: SmartAgentBudgetConfig;
 };
 type SmartAgentPlanningConfig = {
@@ -388,8 +428,8 @@ type SmartAgentToolResponseConfig = {
     toolResponseRetentionByTool?: Record<string, ToolResponseRetentionPolicy>;
     /** Tool names whose responses are never reduced by the summarizer or hard cap. */
     criticalTools?: string[];
+    /** Controls whether Zod-backed tool schemas fail fast or warn on invalid args. */
     schemaValidation?: "strict" | "warn";
-    retryOnSchemaError?: boolean;
 };
 type SmartAgentCustomProfileConfig = {
     extends?: BuiltInRuntimeProfile;
@@ -441,6 +481,10 @@ type SmartAgentOptions = {
     usageConverter?: (finalMessage: AIMessage, fullState: SmartState, model: any) => any;
     outputSchema?: ZodSchema<any>;
     tracing?: TracingConfig;
+    /**
+     * Unified reasoning configuration. Same shape as on `AgentOptions`. See `ReasoningConfig`.
+     */
+    reasoning?: ReasoningConfig;
 };
 type AgentRuntimeConfig = {
     name?: string;
@@ -739,6 +783,34 @@ type SmartState = AgentState & {
         adherenceScore?: number;
     } | null;
     planVersion?: number;
+    /**
+     * Post-turn reflection records produced by the reflection node. The SDK keeps the full
+     * history here (even when only `keepLast` are re-injected into the prompt) so callers
+     * can render them in a task/run timeline.
+     */
+    reflections?: ReflectionRecord[];
+};
+type ReflectionRecord = {
+    id: string;
+    turn: number;
+    /** Plain-text reflection produced by the model. */
+    text: string;
+    createdAt: string;
+    durationMs?: number;
+    /** Index of the last message present when this reflection was taken. */
+    anchorMessageIndex?: number;
+    /** Trigger cadence that fired this reflection. */
+    trigger?: ReflectionCadence;
+    /** Token usage for this specific reflection call. */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cachedInputTokens?: number;
+        totalTokens?: number;
+        reasoningTokens?: number;
+    };
+    /** Optional tool call ids / names the reflection commented on (for UI linking). */
+    toolCallIds?: string[];
 };
 type ToolCallEvent = {
     type: "tool_call";
@@ -918,7 +990,23 @@ type GuardrailEvent = {
     reason?: string;
     details?: Record<string, any>;
 };
-type SmartAgentEvent = ToolCallEvent | ToolApprovalEvent | PlanEvent | SummarizationEvent | FinalAnswerEvent | MetadataEvent | HandoffEvent | GuardrailEvent | ProgressEvent | StreamEvent | CancelledEvent;
+type SmartAgentEvent = ToolCallEvent | ToolApprovalEvent | PlanEvent | SummarizationEvent | FinalAnswerEvent | MetadataEvent | HandoffEvent | GuardrailEvent | ProgressEvent | StreamEvent | CancelledEvent | ReflectionEvent;
+type ReflectionEvent = {
+    type: "reflection";
+    id: string;
+    turn: number;
+    text: string;
+    trigger?: ReflectionCadence;
+    durationMs?: number;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cachedInputTokens?: number;
+        totalTokens?: number;
+        reasoningTokens?: number;
+    };
+    toolCallIds?: string[];
+};
 type CancellationTokenLike = {
     readonly isCancellationRequested: boolean;
     onCancellationRequested?: (listener: () => void) => {
@@ -1471,6 +1559,28 @@ type ChatCompletionRequest = {
     };
     stream?: boolean;
     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;
+};
+type ReasoningEffort = "minimal" | "low" | "medium" | "high";
+type ReasoningRequestConfig = {
+    /** Qualitative effort hint (mapped per-provider). */
+    effort?: ReasoningEffort;
+    /** Explicit per-call token budget for reasoning/thinking. */
+    budgetTokens?: number;
+    /** Whether the provider should expose its reasoning/thought summary to the caller. Default false. */
+    includeThoughts?: boolean;
+    /** Provider-specific passthrough merged on top of the mapped shape. */
+    providerExtras?: Record<string, any>;
 };
 type TokenUsage = {
     inputTokens: number;
@@ -1669,6 +1779,8 @@ type NativeModelOptions = {
     maxTokens?: number;
     /** Provider-specific extras passed on every request */
     extra?: Record<string, any>;
+    /** Unified native reasoning config applied by default (per-call overrides supported). */
+    reasoning?: ReasoningRequestConfig;
 };
 /**
  * Creates a BaseChatModel from a native provider.
@@ -1706,4 +1818,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
  */
 declare function createProvider(config: ProviderConfig): BaseProvider;
 
-export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, BedrockProvider, type BedrockProviderConfig, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type ContextPolicy, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type FinishReason, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailRule, type HandoffDescriptor, type HandoffEvent, InMemoryMemoryStore, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, OpenAIProvider, type OpenAIProviderConfig, type PendingToolApproval, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, type SerializableSmartState, 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 StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, 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 TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, VertexProvider, type VertexProviderConfig, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGuardrail, createJsonGuardrail, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveStrategy, resolveToolApprovalState, restoreSnapshot, runSmartAgentEvalHarness, startStreamingSession, traceSessionToOtlp, withTools, writeSummaryFactsToMemory };
+export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, BedrockProvider, type BedrockProviderConfig, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type ContextPolicy, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type FinishReason, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailRule, type HandoffDescriptor, type HandoffEvent, InMemoryMemoryStore, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, OpenAIProvider, type OpenAIProviderConfig, type PendingToolApproval, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type ReasoningConfig, type ReasoningLevel, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionRecord, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, type SerializableSmartState, 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 StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, 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 TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, VertexProvider, type VertexProviderConfig, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGuardrail, createJsonGuardrail, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveStrategy, resolveToolApprovalState, restoreSnapshot, runSmartAgentEvalHarness, startStreamingSession, traceSessionToOtlp, withTools, writeSummaryFactsToMemory };

package/dist/index.d.ts

@@ -254,6 +254,48 @@ type AgentOptions = {
     usageConverter?: (finalMessage: AIMessage, fullState: SmartState, model: any) => any;
     outputSchema?: ZodSchema<any>;
     tracing?: TracingConfig;
+    /**
+     * Unified reasoning configuration. Controls both:
+     * - Provider-native reasoning (OpenAI reasoning_effort, Anthropic thinking, Gemini thinkingConfig)
+     * - Post-turn reflection (a short textual insight from the model after each tool turn)
+     *
+     * When omitted or `enabled=false` the agent behaves exactly as before.
+     */
+    reasoning?: ReasoningConfig;
+};
+type ReasoningLevel = "low" | "medium" | "high";
+type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch";
+type ReflectionConfig = {
+    enabled?: boolean;
+    cadence?: ReflectionCadence;
+    /**
+     * - "piggyback" (default) — appends a short user-style "reflect now" message to the existing
+     *   transcript, reusing provider prompt cache. No tools. Returned text becomes a reflection record.
+     * - "separate" — dedicated tool-free call with a compact prompt (cheaper, smaller cache hit).
+     */
+    mode?: "piggyback" | "separate";
+    maxTokens?: number;
+    maxChars?: number;
+    keepLast?: number;
+    /** When true reflection messages are compressible by the summarizer. Default false. */
+    summarize?: boolean;
+    promptTemplate?: string;
+    /** When true emits `reflection` SmartAgent events. Default true. */
+    emitEvents?: boolean;
+};
+type NativeReasoningConfig = {
+    effort?: "minimal" | "low" | "medium" | "high";
+    budgetTokens?: number;
+    includeThoughts?: boolean;
+    providerExtras?: Record<string, any>;
+};
+type ReasoningConfig = {
+    enabled?: boolean;
+    level?: ReasoningLevel;
+    /** Pass `false` to disable provider-native reasoning while keeping reflection. */
+    native?: NativeReasoningConfig | false;
+    /** Pass `false` to fully disable reflection. */
+    reflection?: ReflectionConfig | false;
 };
 type BuiltInRuntimeProfile = "fast" | "balanced" | "deep" | "research";
 type RuntimeProfile = BuiltInRuntimeProfile | "custom";
@@ -341,8 +383,6 @@ type SmartAgentContextConfig = {
     policy?: ContextPolicy;
     lastTurnsToKeep?: number;
     toolResponsePolicy?: ToolResponseRetentionPolicy;
-    archiveLargeToolResponses?: boolean;
-    retrieveArchivedToolResponseOnDemand?: boolean;
     budget?: SmartAgentBudgetConfig;
 };
 type SmartAgentPlanningConfig = {
@@ -388,8 +428,8 @@ type SmartAgentToolResponseConfig = {
     toolResponseRetentionByTool?: Record<string, ToolResponseRetentionPolicy>;
     /** Tool names whose responses are never reduced by the summarizer or hard cap. */
     criticalTools?: string[];
+    /** Controls whether Zod-backed tool schemas fail fast or warn on invalid args. */
     schemaValidation?: "strict" | "warn";
-    retryOnSchemaError?: boolean;
 };
 type SmartAgentCustomProfileConfig = {
     extends?: BuiltInRuntimeProfile;
@@ -441,6 +481,10 @@ type SmartAgentOptions = {
     usageConverter?: (finalMessage: AIMessage, fullState: SmartState, model: any) => any;
     outputSchema?: ZodSchema<any>;
     tracing?: TracingConfig;
+    /**
+     * Unified reasoning configuration. Same shape as on `AgentOptions`. See `ReasoningConfig`.
+     */
+    reasoning?: ReasoningConfig;
 };
 type AgentRuntimeConfig = {
     name?: string;
@@ -739,6 +783,34 @@ type SmartState = AgentState & {
         adherenceScore?: number;
     } | null;
     planVersion?: number;
+    /**
+     * Post-turn reflection records produced by the reflection node. The SDK keeps the full
+     * history here (even when only `keepLast` are re-injected into the prompt) so callers
+     * can render them in a task/run timeline.
+     */
+    reflections?: ReflectionRecord[];
+};
+type ReflectionRecord = {
+    id: string;
+    turn: number;
+    /** Plain-text reflection produced by the model. */
+    text: string;
+    createdAt: string;
+    durationMs?: number;
+    /** Index of the last message present when this reflection was taken. */
+    anchorMessageIndex?: number;
+    /** Trigger cadence that fired this reflection. */
+    trigger?: ReflectionCadence;
+    /** Token usage for this specific reflection call. */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cachedInputTokens?: number;
+        totalTokens?: number;
+        reasoningTokens?: number;
+    };
+    /** Optional tool call ids / names the reflection commented on (for UI linking). */
+    toolCallIds?: string[];
 };
 type ToolCallEvent = {
     type: "tool_call";
@@ -918,7 +990,23 @@ type GuardrailEvent = {
     reason?: string;
     details?: Record<string, any>;
 };
-type SmartAgentEvent = ToolCallEvent | ToolApprovalEvent | PlanEvent | SummarizationEvent | FinalAnswerEvent | MetadataEvent | HandoffEvent | GuardrailEvent | ProgressEvent | StreamEvent | CancelledEvent;
+type SmartAgentEvent = ToolCallEvent | ToolApprovalEvent | PlanEvent | SummarizationEvent | FinalAnswerEvent | MetadataEvent | HandoffEvent | GuardrailEvent | ProgressEvent | StreamEvent | CancelledEvent | ReflectionEvent;
+type ReflectionEvent = {
+    type: "reflection";
+    id: string;
+    turn: number;
+    text: string;
+    trigger?: ReflectionCadence;
+    durationMs?: number;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cachedInputTokens?: number;
+        totalTokens?: number;
+        reasoningTokens?: number;
+    };
+    toolCallIds?: string[];
+};
 type CancellationTokenLike = {
     readonly isCancellationRequested: boolean;
     onCancellationRequested?: (listener: () => void) => {
@@ -1471,6 +1559,28 @@ type ChatCompletionRequest = {
     };
     stream?: boolean;
     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;
+};
+type ReasoningEffort = "minimal" | "low" | "medium" | "high";
+type ReasoningRequestConfig = {
+    /** Qualitative effort hint (mapped per-provider). */
+    effort?: ReasoningEffort;
+    /** Explicit per-call token budget for reasoning/thinking. */
+    budgetTokens?: number;
+    /** Whether the provider should expose its reasoning/thought summary to the caller. Default false. */
+    includeThoughts?: boolean;
+    /** Provider-specific passthrough merged on top of the mapped shape. */
+    providerExtras?: Record<string, any>;
 };
 type TokenUsage = {
     inputTokens: number;
@@ -1669,6 +1779,8 @@ type NativeModelOptions = {
     maxTokens?: number;
     /** Provider-specific extras passed on every request */
     extra?: Record<string, any>;
+    /** Unified native reasoning config applied by default (per-call overrides supported). */
+    reasoning?: ReasoningRequestConfig;
 };
 /**
  * Creates a BaseChatModel from a native provider.
@@ -1706,4 +1818,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
  */
 declare function createProvider(config: ProviderConfig): BaseProvider;
 
-export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, BedrockProvider, type BedrockProviderConfig, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type ContextPolicy, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type FinishReason, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailRule, type HandoffDescriptor, type HandoffEvent, InMemoryMemoryStore, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, OpenAIProvider, type OpenAIProviderConfig, type PendingToolApproval, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, type SerializableSmartState, 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 StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, 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 TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, VertexProvider, type VertexProviderConfig, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGuardrail, createJsonGuardrail, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveStrategy, resolveToolApprovalState, restoreSnapshot, runSmartAgentEvalHarness, startStreamingSession, traceSessionToOtlp, withTools, writeSummaryFactsToMemory };
+export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, BedrockProvider, type BedrockProviderConfig, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type ContextPolicy, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type FinishReason, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailRule, type HandoffDescriptor, type HandoffEvent, InMemoryMemoryStore, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, OpenAIProvider, type OpenAIProviderConfig, type PendingToolApproval, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type ReasoningConfig, type ReasoningLevel, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionRecord, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, type SerializableSmartState, 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 StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, 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 TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, VertexProvider, type VertexProviderConfig, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGuardrail, createJsonGuardrail, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveStrategy, resolveToolApprovalState, restoreSnapshot, runSmartAgentEvalHarness, startStreamingSession, traceSessionToOtlp, withTools, writeSummaryFactsToMemory };