@cognipeer/agent-sdk 0.4.9 → 0.5.1

package/dist/index.d.cts

@@ -1,6 +1,60 @@
-import { ZodSchema, z } from 'zod';
+import { ZodError, ZodSchema, z } from 'zod';
 import { JSONSchema7 } from 'json-schema';
 
+/** Describes what a model/provider natively supports. */
+type ModelCapabilities = {
+    /** How the model supports structured output:
+     *  - "native": model accepts response_format with json_schema (OpenAI, Gemini, etc.)
+     *  - "tool_based": structured output must be emulated via a response tool
+     */
+    structuredOutput?: "native" | "tool_based";
+    /** Whether tools must be bound with strict=true for native structured output auto-parsing. */
+    strictToolCalling?: boolean;
+    /** Whether the model supports streaming */
+    streaming?: boolean;
+    /** Provider identifier (e.g. "openai", "anthropic", "bedrock", "google") */
+    provider?: string;
+};
+type StructuredOutputFieldError = {
+    path: string;
+    expected: string;
+    received: string;
+    message: string;
+};
+type StructuredOutputError = {
+    type: "parse_error" | "validation_error" | "no_output" | "max_retries";
+    message: string;
+    fieldErrors?: StructuredOutputFieldError[];
+    rawContent?: string;
+};
+type StructuredOutputResult<T> = {
+    success: true;
+    data: T;
+    attempts: number;
+} | {
+    success: false;
+    error: StructuredOutputError;
+    attempts: number;
+    rawContent?: string;
+};
+/**
+ * Encapsulates how structured output is achieved for a given model/provider.
+ * NativeJsonSchemaStrategy uses response_format; ToolBasedStrategy uses a response tool.
+ */
+interface StructuredOutputStrategy {
+    readonly kind: "native" | "tool_based";
+    /**
+     * Build a correction prompt when validation fails.
+     * The prompt tells the model exactly which fields were wrong.
+     */
+    buildCorrectionPrompt(error: ZodError<any>, previousAttempt: unknown): string;
+}
+type StructuredOutputManagerConfig = {
+    maxRetries?: number;
+};
+declare function getNestedValue(obj: unknown, path: (string | number)[]): unknown;
+declare function formatZodError(error: ZodError<any>, rawContent?: string): StructuredOutputError;
+
 interface BaseChatMessagePart {
     type?: string;
     text?: string;
@@ -37,13 +91,20 @@ interface BaseChatModel {
             isCancellationRequested: boolean;
         };
     }): AsyncIterable<BaseChatMessage | BaseChatMessagePart | string>;
-    bindTools?(tools: any[]): BaseChatModel;
+    bindTools?(tools: any[], options?: {
+        strict?: boolean;
+        [key: string]: any;
+    }): BaseChatModel;
     modelName?: string;
+    capabilities?: ModelCapabilities;
     [key: string]: any;
 }
 type SmartModel = BaseChatModel;
 declare function isSmartModel(m: any): m is SmartModel;
-declare function withTools(model: SmartModel, tools: any[]): BaseChatModel;
+declare function withTools(model: SmartModel, tools: any[], options?: {
+    strict?: boolean;
+    [key: string]: any;
+}): BaseChatModel;
 declare function fromLangchainModel(lcModel: any): BaseChatModel;
 
 type ImageURL = {
@@ -54,7 +115,7 @@ type ImageURL = {
     media_type?: string;
     detail?: 'auto' | 'low' | 'high';
 } | string;
-type ContentPart = {
+type ContentPart$1 = {
     type: 'text';
     text: string;
 } | {
@@ -82,7 +143,7 @@ type RunnableConfig = {
 type BaseMessage = {
     role: string;
     name?: string;
-    content: string | ContentPart[];
+    content: string | ContentPart$1[];
     tool_calls?: any;
     tool_call_id?: string;
     [key: string]: any;
@@ -377,6 +438,7 @@ type AgentRuntimeConfig = {
     limits?: AgentLimits;
     useTodoList?: boolean;
     outputSchema?: ZodSchema<any>;
+    responseFormat?: Record<string, any>;
     tracing?: TracingConfig;
     runtimeProfile?: RuntimeProfile;
     smart?: ResolvedSmartAgentConfig;
@@ -906,6 +968,7 @@ type RestoreSnapshotOptions = {
 type AgentInvokeResult<TOutput = unknown> = {
     content: string;
     output?: TOutput;
+    outputError?: StructuredOutputError;
     metadata: {
         usage?: any;
     };
@@ -971,24 +1034,6 @@ declare function createToolLimitFinalizeNode(_opts: SmartAgentOptions): (state:
  */
 declare function createContextSummarizeNode(opts: SmartAgentOptions): (state: SmartState) => Promise<Partial<SmartState>>;
 
-type TokenLimits = {
-    contextTokenLimit: number;
-    summaryTokenLimit: number;
-};
-declare function applyTokenLimits({ state, limits, }: {
-    state: {
-        messages: Message[];
-        summaries?: string[];
-    };
-    limits: {
-        contextTokenLimit: number;
-        summaryTokenLimit: number;
-    };
-}): Promise<{
-    messages: Message[];
-    summaries?: string[];
-}>;
-
 /**
  * Estimates token count from text using a character-based heuristic.
  *
@@ -1048,7 +1093,6 @@ declare class InMemoryMemoryStore implements MemoryStore {
 declare function resolveMemoryStore(config: ResolvedSmartAgentConfig): MemoryStore | undefined;
 declare function readMemoryFacts(store: MemoryStore | undefined, config: ResolvedSmartAgentConfig, query: string): Promise<MemoryFact[]>;
 declare function writeSummaryFactsToMemory(store: MemoryStore | undefined, config: ResolvedSmartAgentConfig, summary: StructuredSummary | undefined, sourceTurn: number): Promise<MemoryFact[]>;
-declare function renderMemoryFacts(facts: MemoryFact[]): string;
 
 declare const DEFAULT_PROFILE_CONFIGS: Record<BuiltInRuntimeProfile, ProfileConfig>;
 declare function normalizeSmartAgentOptions(opts: SmartAgentOptions): ResolvedSmartAgentConfig;
@@ -1176,6 +1220,152 @@ type CodeGuardrailOptions = GuardrailPresetBase & {
 };
 declare function createCodeGuardrail(options?: CodeGuardrailOptions): ConversationGuardrail;
 
+/**
+ * Centralized manager for structured output across both base Agent and SmartAgent.
+ *
+ * Responsibilities:
+ * - Prepare tools or response_format depending on the resolved strategy
+ * - Build system prompt hints tailored to the strategy
+ * - Build nudge/correction prompts for retries
+ * - Parse final output from tool result or assistant content
+ * - Report structured errors (never silently swallow)
+ */
+declare class StructuredOutputManager<T> {
+    readonly strategy: StructuredOutputStrategy;
+    readonly schema: ZodSchema<T>;
+    readonly maxRetries: number;
+    constructor(schema: ZodSchema<T>, strategy: StructuredOutputStrategy, config?: StructuredOutputManagerConfig);
+    /**
+     * Get the `response` tool for tool-based strategy.
+     * Returns undefined for native strategy (no tool needed).
+     */
+    getResponseTool(): ToolInterface | undefined;
+    /**
+     * Get response_format config for native strategy.
+     * Returns undefined for tool-based strategy.
+     */
+    getResponseFormat(): Record<string, any> | undefined;
+    /**
+     * Build the system prompt hint that tells the model how to produce structured output.
+     */
+    buildSystemPromptHint(): string;
+    /**
+     * Build a nudge message for when the model didn't produce structured output.
+     * Used by the agent loop when it needs to retry.
+     */
+    buildNudgeMessage(isLastAttempt: boolean): {
+        role: string;
+        content: string;
+    };
+    /**
+     * Build a correction message when schema validation failed.
+     */
+    buildCorrectionMessage(error: StructuredOutputError, _previousAttempt?: unknown): {
+        role: string;
+        content: string;
+    };
+    /**
+     * Try to parse structured output from the tool-based finalization result.
+     * Called when __structuredOutputParsed is available in ctx.
+     */
+    parseFromToolResult(data: unknown): StructuredOutputResult<T>;
+    /**
+     * Try to parse structured output from assistant message content.
+     * For native strategy: content should be valid JSON.
+     * For tool-based strategy: last-resort fallback extraction from text.
+     */
+    parseFromContent(content: string): StructuredOutputResult<T>;
+    /**
+     * Create a "no output" error result.
+     */
+    noOutputResult(attempts: number, rawContent?: string): StructuredOutputResult<T>;
+    /**
+     * Create a "max retries" error result.
+     */
+    maxRetriesResult(lastError: StructuredOutputError, attempts: number, rawContent?: string): StructuredOutputResult<T>;
+}
+
+/**
+ * Tool-based structured output strategy.
+ *
+ * Injects a hidden `response` tool that the model must call with the final JSON.
+ * This is the universal fallback that works with all providers.
+ */
+declare class ToolBasedStrategy implements StructuredOutputStrategy {
+    readonly kind: "tool_based";
+    /**
+     * Create the `response` tool for a given Zod schema.
+     * The tool validates input against the schema and returns a sentinel object
+     * that the tools node picks up to finalize the structured output.
+     */
+    createResponseTool<T>(schema: ZodSchema<T>): ToolInterface;
+    /**
+     * Try to extract structured output from raw assistant text content.
+     * Used as a last resort when the model writes JSON directly instead of calling the tool.
+     */
+    extractFromText<T>(content: string, schema: ZodSchema<T>): {
+        data: T;
+    } | {
+        error: StructuredOutputError;
+    };
+    buildCorrectionPrompt(error: ZodError<any>, previousAttempt: unknown): string;
+}
+
+/**
+ * Native JSON Schema strategy for providers that support `response_format`.
+ *
+ * Works with OpenAI (gpt-4o+), Google Gemini, and similar providers
+ * that accept `response_format: { type: "json_schema", json_schema: {...} }`.
+ *
+ * The model guarantees valid JSON output matching the schema — no tool needed.
+ */
+declare class NativeJsonSchemaStrategy implements StructuredOutputStrategy {
+    readonly kind: "native";
+    private resolveJsonPointer;
+    private unwrapRootObjectSchema;
+    private normalizeOpenAIStrictSchema;
+    /**
+     * Convert a Zod schema to the JSON Schema object used in response_format.
+     */
+    toJsonSchema(schema: ZodSchema<any>, name?: string): Record<string, any>;
+    /**
+     * Build response_format configuration for the model call.
+     * Returns the object that should be spread into model invocation options.
+     */
+    buildResponseFormat(schema: ZodSchema<any>, name?: string): Record<string, any>;
+    /**
+     * Parse and validate model response content.
+     * With native support, content is guaranteed JSON — but we still validate with Zod
+     * for type safety and field-level error reporting.
+     */
+    extractOutput<T>(content: string, schema: ZodSchema<T>): {
+        data: T;
+    } | {
+        error: StructuredOutputError;
+    };
+    buildCorrectionPrompt(error: ZodError<any>, previousAttempt: unknown): string;
+}
+
+/**
+ * Resolve the most appropriate structured output strategy for a given model.
+ *
+ * If the model exposes capabilities (via adapter or direct provider),
+ * we use native JSON Schema support when available. Otherwise we fall back
+ * to the universal tool-based approach.
+ *
+ * When direct providers are added to the SDK, they should set
+ * `model.capabilities.structuredOutput = "native"` for providers that support
+ * response_format (OpenAI, Gemini, etc.).
+ */
+declare function resolveStrategy(model: any): StructuredOutputStrategy;
+/**
+ * Extract capabilities from a model object.
+ * Supports:
+ *   - model.capabilities (set by adapters or direct providers)
+ *   - Auto-detection from model class name / metadata
+ */
+declare function getModelCapabilities(model: any): ModelCapabilities;
+
 declare function captureSnapshot(state: SmartState, options?: SnapshotOptions): AgentSnapshot;
 declare function restoreSnapshot(snapshot: AgentSnapshot, restoreOptions?: RestoreSnapshotOptions): SmartState;
 
@@ -1213,4 +1403,292 @@ declare function generateSpanId(): string;
  */
 declare function startStreamingSession(session: TraceSessionRuntime | undefined, agentRuntime?: AgentRuntimeConfig): Promise<void>;
 
-export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, 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 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 PendingToolApproval, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, 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 StructuredSummary, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenLimits, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, 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, agentVerdictRule, applyTokenLimits, buildSystemPrompt, captureSnapshot, codePresenceRule, cognipeerSink, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGuardrail, createJsonGuardrail, createRegexGuardrail, createResolverNode, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, evaluateGuardrails, fileSink, fromLangchainModel, fromLangchainTools, generateSpanId, generateTraceId, getResolvedSmartConfig, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, renderMemoryFacts, resolveMemoryStore, resolveToolApprovalState, restoreSnapshot, runSmartAgentEvalHarness, startStreamingSession, traceSessionToOtlp, withTools, writeSummaryFactsToMemory };
+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;
+    };
+};
+type ContentPart = TextContent | ImageContent;
+type ToolCall = {
+    id: string;
+    name: string;
+    arguments: string;
+};
+type UnifiedMessage = {
+    role: MessageRole;
+    content: string | ContentPart[];
+    name?: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+};
+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[];
+    tools?: ToolDefinition[];
+    toolChoice?: "auto" | "required" | "none" | {
+        name: string;
+    };
+    responseFormat?: {
+        type: "json_schema" | "json_object" | "text";
+        schema?: Record<string, any>;
+        name?: string;
+    };
+    stream?: boolean;
+    extra?: 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 ChatCompletionResponse = {
+    id: string;
+    model: string;
+    content: string | null;
+    toolCalls: ToolCall[];
+    usage: TokenUsage;
+    finishReason: FinishReason;
+    raw: any;
+};
+type ChatCompletionChunk = {
+    id: string;
+    model: string;
+    delta: {
+        content?: string;
+        toolCalls?: Partial<ToolCall>[];
+    };
+    usage?: TokenUsage;
+    finishReason?: FinishReason;
+};
+type OpenAIProviderConfig = {
+    provider: "openai";
+    apiKey: string;
+    baseURL?: string;
+    organization?: string;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+};
+type AnthropicProviderConfig = {
+    provider: "anthropic";
+    apiKey: string;
+    baseURL?: string;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+    anthropicVersion?: string;
+};
+type AzureProviderConfig = {
+    provider: "azure";
+    apiKey: string;
+    endpoint: string;
+    apiVersion?: string;
+    deploymentName?: string;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+};
+type OpenAICompatibleProviderConfig = {
+    provider: "openai-compatible";
+    apiKey: string;
+    baseURL: string;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+};
+type BedrockProviderConfig = {
+    provider: "bedrock";
+    region: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+};
+type VertexProviderConfig = {
+    provider: "vertex";
+    projectId: string;
+    location?: string;
+    accessToken?: string;
+    serviceAccountJson?: string | Record<string, any>;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+};
+type ProviderConfig = OpenAIProviderConfig | AnthropicProviderConfig | AzureProviderConfig | OpenAICompatibleProviderConfig | BedrockProviderConfig | VertexProviderConfig;
+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);
+}
+
+declare abstract class BaseProvider {
+    abstract readonly providerName: ProviderType;
+    /** Non-streaming completion */
+    abstract complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /** Streaming completion – yields incremental chunks */
+    abstract completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+}
+
+declare class OpenAIProvider extends BaseProvider {
+    readonly providerName: ProviderType;
+    protected readonly apiKey: string;
+    protected readonly baseURL: string;
+    protected readonly defaultModel: string;
+    protected readonly defaultHeaders: Record<string, string>;
+    constructor(config: OpenAIProviderConfig);
+    complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+    protected buildRequestBody(request: ChatCompletionRequest, stream: boolean): Record<string, any>;
+    protected toOpenAIMessage(m: UnifiedMessage): Record<string, any>;
+    protected toOpenAITool(t: ToolDefinition): Record<string, any>;
+    protected doFetch(body: Record<string, any>): Promise<Response>;
+    protected parseResponse(json: any): ChatCompletionResponse;
+    protected extractUsage(usage: any): TokenUsage;
+}
+
+declare class AnthropicProvider extends BaseProvider {
+    readonly providerName: ProviderType;
+    private readonly apiKey;
+    private readonly baseURL;
+    private readonly defaultModel;
+    private readonly defaultHeaders;
+    private readonly anthropicVersion;
+    constructor(config: AnthropicProviderConfig);
+    complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+    private buildRequestBody;
+    private splitSystemMessages;
+    private toAnthropicMessage;
+    private toAnthropicTool;
+    private doFetch;
+    private parseResponse;
+}
+
+declare class AzureProvider extends OpenAIProvider {
+    readonly providerName: ProviderType;
+    private readonly endpoint;
+    private readonly apiVersion;
+    private readonly deploymentName?;
+    private readonly azureApiKey;
+    constructor(config: AzureProviderConfig);
+    protected doFetch(body: Record<string, any>): Promise<Response>;
+}
+
+declare class OpenAICompatibleProvider extends OpenAIProvider {
+    readonly providerName: ProviderType;
+    constructor(config: OpenAICompatibleProviderConfig);
+}
+
+declare class BedrockProvider extends BaseProvider {
+    readonly providerName: ProviderType;
+    private readonly region;
+    private readonly credentials;
+    private readonly defaultModel;
+    private readonly defaultHeaders;
+    constructor(config: BedrockProviderConfig);
+    complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+    private buildConverseBody;
+    private splitSystemMessages;
+    private toBedrockMessage;
+    private toBedrockTool;
+    private doFetch;
+    private parseResponse;
+}
+
+declare class VertexProvider extends BaseProvider {
+    readonly providerName: ProviderType;
+    private readonly projectId;
+    private readonly location;
+    private readonly defaultModel;
+    private readonly defaultHeaders;
+    private accessToken?;
+    private serviceAccountJson?;
+    private tokenExpiry;
+    constructor(config: VertexProviderConfig);
+    complete(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+    private buildUrl;
+    private buildGeminiBody;
+    private buildContents;
+    private toGeminiContent;
+    private toGeminiTool;
+    private getAccessToken;
+    private getTokenFromServiceAccount;
+    private doFetch;
+    private parseResponse;
+    private parseStreamChunk;
+}
+
+type NativeModelOptions = {
+    /** Override the model ID per adapter instance */
+    model?: string;
+    /** Default temperature */
+    temperature?: number;
+    /** Default max tokens */
+    maxTokens?: number;
+    /** Provider-specific extras passed on every request */
+    extra?: Record<string, any>;
+};
+/**
+ * Creates a BaseChatModel from a native provider.
+ *
+ * Usage:
+ * ```ts
+ * const provider = createProvider({ provider: "openai", apiKey: "..." });
+ * const model = fromNativeProvider(provider, { model: "gpt-4o" });
+ * const agent = createSmartAgent({ model, tools: [...] });
+ * ```
+ */
+declare function fromNativeProvider(provider: BaseProvider, options?: NativeModelOptions): BaseChatModel;
+
+/**
+ * Factory function to create a provider from a config object.
+ *
+ * @example
+ * ```ts
+ * const provider = createProvider({
+ *   provider: "openai",
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ * });
+ *
+ * // Direct usage
+ * const response = await provider.complete({
+ *   model: "gpt-4o",
+ *   messages: [{ role: "user", content: "Hello!" }],
+ * });
+ *
+ * // Or wrap as BaseChatModel for agent-sdk
+ * import { fromNativeProvider } from "./adapter";
+ * const model = fromNativeProvider(provider, { model: "gpt-4o" });
+ * const agent = createSmartAgent({ model, tools: [...] });
+ * ```
+ */
+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 };