@cognipeer/agent-sdk 0.7.0 → 0.7.1

package/dist/index.d.cts

@@ -306,8 +306,16 @@ type AgentOptions = {
      */
     humanInTheLoop?: HumanInTheLoopOptions;
 };
-type ReasoningLevel = "low" | "medium" | "high";
-type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch";
+type ReasoningLevel = "minimal" | "low" | "medium" | "high";
+type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch" | "initial_then_after_tool";
+/** Context passed to reflection lifecycle hooks. */
+type ReflectionHookContext = {
+    state: SmartState;
+    /** The turn number (state.toolCallCount) at the time of the decision. */
+    turn: number;
+    trigger: ReflectionCadence;
+    ranToolsThisTurn: boolean;
+};
 type ReflectionConfig = {
     enabled?: boolean;
     cadence?: ReflectionCadence;
@@ -337,6 +345,29 @@ type ReflectionConfig = {
      * turn, etc. Independent of `cadence`.
      */
     everyNTurns?: number;
+    /**
+     * Where to route the reflection text in addition to the reflection record:
+     * - "memory" — store as a low-confidence agent-scoped `MemoryFact`.
+     * - "plan"   — append the note to the active plan's `lastReflection` field.
+     * - "none"   — record only (default).
+     */
+    feedTo?: "memory" | "plan" | "none";
+    /**
+     * Custom predicate that overrides the built-in cadence decision. Return true
+     * to force a reflection on this turn, false to skip. `maxPerRun`/`everyNTurns`
+     * throttles still apply on top of this.
+     */
+    shouldReflect?: (ctx: ReflectionHookContext) => boolean;
+    /**
+     * Build the reflection prompt body. Receives the resolved default prompt and
+     * the char budget; return the prompt text to send. Overrides `promptTemplate`.
+     */
+    buildPrompt?: (ctx: ReflectionHookContext & {
+        defaultPrompt: string;
+        maxChars: number;
+    }) => string;
+    /** Side-effect hook invoked after a reflection record is produced. */
+    onReflection?: (record: ReflectionRecord, ctx: ReflectionHookContext) => void;
 };
 type NativeReasoningConfig = {
     effort?: "minimal" | "low" | "medium" | "high";
@@ -883,6 +914,7 @@ type SmartState = AgentState & {
         steps: PlanStepRecord[];
         lastUpdated?: string;
         adherenceScore?: number;
+        lastReflection?: string;
     } | null;
     planVersion?: number;
     /**
@@ -1729,6 +1761,39 @@ declare function createAskUserQuestionTool(stateRef: AskUserStateRef, config: Hu
 
 declare function fromLangchainTools<T extends ToolInterface = ToolInterface>(tools: any[]): T[];
 
+type ResolvedReflectionConfig = {
+    enabled: boolean;
+    cadence: ReflectionCadence;
+    mode: "piggyback" | "separate";
+    maxTokens: number;
+    maxChars: number;
+    keepLast: number;
+    summarize: boolean;
+    promptTemplate?: string;
+    emitEvents: boolean;
+    maxPerRun?: number;
+    everyNTurns: number;
+    feedTo: "memory" | "plan" | "none";
+    shouldReflect?: (ctx: ReflectionHookContext) => boolean;
+    buildPrompt?: (ctx: ReflectionHookContext & {
+        defaultPrompt: string;
+        maxChars: number;
+    }) => string;
+    onReflection?: (record: ReflectionRecord, ctx: ReflectionHookContext) => void;
+};
+type ResolvedReasoning = {
+    enabled: boolean;
+    level: ReasoningLevel;
+    native?: NativeReasoningConfig;
+    reflection: ResolvedReflectionConfig;
+};
+/**
+ * Validates a user-supplied ReasoningConfig and throws a descriptive error for
+ * obviously-wrong values. Pure; safe to call before resolveReasoning.
+ */
+declare function validateReasoningConfig(input: ReasoningConfig | undefined): void;
+declare function resolveReasoning(input: ReasoningConfig | undefined): ResolvedReasoning | undefined;
+
 declare function fileSink(path?: string): TraceSinkConfig;
 type CustomSinkArg = ((event: TraceEventRecord) => void | Promise<void>) | {
     onEvent?: (event: TraceEventRecord) => void | Promise<void>;
@@ -1781,12 +1846,35 @@ type ToolCall = {
     name: string;
     arguments: string;
 };
+/**
+ * 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;
@@ -1853,6 +1941,8 @@ type ChatCompletionResponse = {
     toolCalls: ToolCall[];
     usage: TokenUsage;
     finishReason: FinishReason;
+    /** Native reasoning blocks + summary captured from the response, if any. */
+    reasoning?: ReasoningPayload;
     raw: any;
 };
 type ChatCompletionChunk = {
@@ -1861,6 +1951,8 @@ type ChatCompletionChunk = {
     delta: {
         content?: string;
         toolCalls?: Partial<ToolCall>[];
+        /** Incremental reasoning text / signature deltas (Anthropic thinking). */
+        reasoning?: ReasoningPayload;
     };
     usage?: TokenUsage;
     finishReason?: FinishReason;
@@ -1988,9 +2080,19 @@ declare class OpenAIProvider extends BaseProvider {
     protected readonly defaultModel: string;
     protected readonly defaultHeaders: Record<string, string>;
     constructor(config: OpenAIProviderConfig);
+    /** True when the request targets a reasoning model (o-series / gpt-5) so we
+     * should route through the Responses API, which exposes `reasoning.effort`
+     * and reasoning summaries. Chat Completions silently drops these. */
+    protected useResponsesApi(request: ChatCompletionRequest): boolean;
     complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
     completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
     protected buildRequestBody(request: ChatCompletionRequest, stream: boolean): Record<string, any>;
+    protected completeResponses(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    protected buildResponsesBody(request: ChatCompletionRequest): 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>): Promise<Response>;
+    protected parseResponsesResponse(json: any, modelId: string): ChatCompletionResponse;
     protected toOpenAIMessage(m: UnifiedMessage): Record<string, any>;
     protected toOpenAITool(t: ToolDefinition): Record<string, any>;
     protected doFetch(body: Record<string, any>): Promise<Response>;
@@ -2025,6 +2127,10 @@ declare class AzureProvider extends OpenAIProvider {
     private readonly azureApiKey;
     constructor(config: AzureProviderConfig);
     protected doFetch(body: Record<string, any>): Promise<Response>;
+    /** Azure exposes the Responses API at /openai/responses with api-key auth.
+     * Reasoning summaries require a preview api-version; callers can override via
+     * the `apiVersion` config. */
+    protected responsesFetch(body: Record<string, any>): Promise<Response>;
 }
 
 declare class OpenAICompatibleProvider extends OpenAIProvider {
@@ -2122,4 +2228,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 ContextToolsStateRef, 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, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, 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 PendingUserQuestion, 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 TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetryPolicy, 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 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, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveStrategy, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, setTokenCounter, 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 ContextToolsStateRef, 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, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, 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 PendingUserQuestion, 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 ReflectionHookContext, 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 TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetryPolicy, 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 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, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, setTokenCounter, startStreamingSession, traceSessionToOtlp, validateReasoningConfig, withTools, writeSummaryFactsToMemory };

package/dist/index.d.ts

@@ -306,8 +306,16 @@ type AgentOptions = {
      */
     humanInTheLoop?: HumanInTheLoopOptions;
 };
-type ReasoningLevel = "low" | "medium" | "high";
-type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch";
+type ReasoningLevel = "minimal" | "low" | "medium" | "high";
+type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch" | "initial_then_after_tool";
+/** Context passed to reflection lifecycle hooks. */
+type ReflectionHookContext = {
+    state: SmartState;
+    /** The turn number (state.toolCallCount) at the time of the decision. */
+    turn: number;
+    trigger: ReflectionCadence;
+    ranToolsThisTurn: boolean;
+};
 type ReflectionConfig = {
     enabled?: boolean;
     cadence?: ReflectionCadence;
@@ -337,6 +345,29 @@ type ReflectionConfig = {
      * turn, etc. Independent of `cadence`.
      */
     everyNTurns?: number;
+    /**
+     * Where to route the reflection text in addition to the reflection record:
+     * - "memory" — store as a low-confidence agent-scoped `MemoryFact`.
+     * - "plan"   — append the note to the active plan's `lastReflection` field.
+     * - "none"   — record only (default).
+     */
+    feedTo?: "memory" | "plan" | "none";
+    /**
+     * Custom predicate that overrides the built-in cadence decision. Return true
+     * to force a reflection on this turn, false to skip. `maxPerRun`/`everyNTurns`
+     * throttles still apply on top of this.
+     */
+    shouldReflect?: (ctx: ReflectionHookContext) => boolean;
+    /**
+     * Build the reflection prompt body. Receives the resolved default prompt and
+     * the char budget; return the prompt text to send. Overrides `promptTemplate`.
+     */
+    buildPrompt?: (ctx: ReflectionHookContext & {
+        defaultPrompt: string;
+        maxChars: number;
+    }) => string;
+    /** Side-effect hook invoked after a reflection record is produced. */
+    onReflection?: (record: ReflectionRecord, ctx: ReflectionHookContext) => void;
 };
 type NativeReasoningConfig = {
     effort?: "minimal" | "low" | "medium" | "high";
@@ -883,6 +914,7 @@ type SmartState = AgentState & {
         steps: PlanStepRecord[];
         lastUpdated?: string;
         adherenceScore?: number;
+        lastReflection?: string;
     } | null;
     planVersion?: number;
     /**
@@ -1729,6 +1761,39 @@ declare function createAskUserQuestionTool(stateRef: AskUserStateRef, config: Hu
 
 declare function fromLangchainTools<T extends ToolInterface = ToolInterface>(tools: any[]): T[];
 
+type ResolvedReflectionConfig = {
+    enabled: boolean;
+    cadence: ReflectionCadence;
+    mode: "piggyback" | "separate";
+    maxTokens: number;
+    maxChars: number;
+    keepLast: number;
+    summarize: boolean;
+    promptTemplate?: string;
+    emitEvents: boolean;
+    maxPerRun?: number;
+    everyNTurns: number;
+    feedTo: "memory" | "plan" | "none";
+    shouldReflect?: (ctx: ReflectionHookContext) => boolean;
+    buildPrompt?: (ctx: ReflectionHookContext & {
+        defaultPrompt: string;
+        maxChars: number;
+    }) => string;
+    onReflection?: (record: ReflectionRecord, ctx: ReflectionHookContext) => void;
+};
+type ResolvedReasoning = {
+    enabled: boolean;
+    level: ReasoningLevel;
+    native?: NativeReasoningConfig;
+    reflection: ResolvedReflectionConfig;
+};
+/**
+ * Validates a user-supplied ReasoningConfig and throws a descriptive error for
+ * obviously-wrong values. Pure; safe to call before resolveReasoning.
+ */
+declare function validateReasoningConfig(input: ReasoningConfig | undefined): void;
+declare function resolveReasoning(input: ReasoningConfig | undefined): ResolvedReasoning | undefined;
+
 declare function fileSink(path?: string): TraceSinkConfig;
 type CustomSinkArg = ((event: TraceEventRecord) => void | Promise<void>) | {
     onEvent?: (event: TraceEventRecord) => void | Promise<void>;
@@ -1781,12 +1846,35 @@ type ToolCall = {
     name: string;
     arguments: string;
 };
+/**
+ * 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;
@@ -1853,6 +1941,8 @@ type ChatCompletionResponse = {
     toolCalls: ToolCall[];
     usage: TokenUsage;
     finishReason: FinishReason;
+    /** Native reasoning blocks + summary captured from the response, if any. */
+    reasoning?: ReasoningPayload;
     raw: any;
 };
 type ChatCompletionChunk = {
@@ -1861,6 +1951,8 @@ type ChatCompletionChunk = {
     delta: {
         content?: string;
         toolCalls?: Partial<ToolCall>[];
+        /** Incremental reasoning text / signature deltas (Anthropic thinking). */
+        reasoning?: ReasoningPayload;
     };
     usage?: TokenUsage;
     finishReason?: FinishReason;
@@ -1988,9 +2080,19 @@ declare class OpenAIProvider extends BaseProvider {
     protected readonly defaultModel: string;
     protected readonly defaultHeaders: Record<string, string>;
     constructor(config: OpenAIProviderConfig);
+    /** True when the request targets a reasoning model (o-series / gpt-5) so we
+     * should route through the Responses API, which exposes `reasoning.effort`
+     * and reasoning summaries. Chat Completions silently drops these. */
+    protected useResponsesApi(request: ChatCompletionRequest): boolean;
     complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
     completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
     protected buildRequestBody(request: ChatCompletionRequest, stream: boolean): Record<string, any>;
+    protected completeResponses(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    protected buildResponsesBody(request: ChatCompletionRequest): 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>): Promise<Response>;
+    protected parseResponsesResponse(json: any, modelId: string): ChatCompletionResponse;
     protected toOpenAIMessage(m: UnifiedMessage): Record<string, any>;
     protected toOpenAITool(t: ToolDefinition): Record<string, any>;
     protected doFetch(body: Record<string, any>): Promise<Response>;
@@ -2025,6 +2127,10 @@ declare class AzureProvider extends OpenAIProvider {
     private readonly azureApiKey;
     constructor(config: AzureProviderConfig);
     protected doFetch(body: Record<string, any>): Promise<Response>;
+    /** Azure exposes the Responses API at /openai/responses with api-key auth.
+     * Reasoning summaries require a preview api-version; callers can override via
+     * the `apiVersion` config. */
+    protected responsesFetch(body: Record<string, any>): Promise<Response>;
 }
 
 declare class OpenAICompatibleProvider extends OpenAIProvider {
@@ -2122,4 +2228,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 ContextToolsStateRef, 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, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, 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 PendingUserQuestion, 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 TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetryPolicy, 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 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, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveStrategy, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, setTokenCounter, 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 ContextToolsStateRef, 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, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, 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 PendingUserQuestion, 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 ReflectionHookContext, 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 TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetryPolicy, 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 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, agentVerdictRule, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createProvider, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, setTokenCounter, startStreamingSession, traceSessionToOtlp, validateReasoningConfig, withTools, writeSummaryFactsToMemory };