@cognipeer/agent-sdk 0.7.0 → 0.7.2

package/dist/index.d.ts

@@ -107,6 +107,71 @@ declare function withTools(model: SmartModel, tools: any[], options?: {
 }): BaseChatModel;
 declare function fromLangchainModel(lcModel: any): BaseChatModel;
 
+/**
+ * Skill primitive — progressive capability disclosure for the smart agent.
+ *
+ * A Skill is a lazy, self-contained capability bundle. The model always sees a
+ * cheap one-line `header`; it calls `open_skill(key)` to load the skill's prompt
+ * and (for small skills) bind its tools, or `bind_skill_tools(key, names)` to
+ * bind a chosen subset of a fat skill. This keeps the number of bound tools per
+ * step small — the property small models need — and replaces an up-front
+ * tool-selector pass with on-demand disclosure.
+ */
+type SkillToolHeader = {
+    name: string;
+    description?: string;
+};
+type SkillModelTier = "small" | "large";
+type Skill = {
+    /** Stable key, e.g. "mcp:atlassian" | "integration:google" | "builtin:drawio". */
+    key: string;
+    title: string;
+    /** One-line "what + when to use" the model always sees in the catalog. */
+    header: string;
+    /** Injected (as the open_skill result) only after the skill is opened. */
+    prompt: string | (() => Promise<string> | string);
+    /** When true, opening this skill should trigger sandbox bootstrap. */
+    needsSandbox?: boolean;
+    /** Gate: a "large"-only skill is hidden from a small-tier model. */
+    minModelTier?: SkillModelTier;
+    /** Whether the skill is usable in the current workspace (integration connected, etc.). */
+    isAvailable?: () => boolean | Promise<boolean>;
+    /** Cheap list of the skill's tool headers (names + one-liners). */
+    listToolIndex: () => Promise<SkillToolHeader[]> | SkillToolHeader[];
+    /** Bind concrete tools. With no names, bind the whole (small) skill. */
+    bindTools: (names?: string[]) => Promise<ToolInterface[]> | ToolInterface[];
+    /** Optional embedding/heuristic ranking of tool headers for a fat skill. */
+    rankToolHeaders?: (query: string, headers: SkillToolHeader[]) => Promise<SkillToolHeader[]> | SkillToolHeader[];
+    /** Deterministic floor: tools to bind when a weak model gives no usable query. */
+    defaultBindNames?: string[];
+};
+type SkillPolicy = {
+    /** Max distinct skills open at once (small tier should be 1). */
+    maxOpenSkills: number;
+    /** Max tools bound from a single skill in one bind call. */
+    maxBoundToolsPerSkill: number;
+    /** Overall cap on skill-bound tools across the whole run. */
+    maxBoundToolsTotal: number;
+    /** Current model tier; gates `minModelTier`. */
+    modelTier?: SkillModelTier;
+};
+declare const DEFAULT_SKILL_POLICY: SkillPolicy;
+declare const SMALL_TIER_SKILL_POLICY: SkillPolicy;
+/**
+ * Mutable per-invoke registry. The skill tools mutate this ref (append-only) and
+ * call `__onToolsChanged` so the runtime can rebuild its tool sets. Mirrors the
+ * stateRef pattern used by createAskUserQuestionTool.
+ */
+type SkillRegistryRef = {
+    /** Append-only: skills the model has opened this run. */
+    openedSkillKeys: string[];
+    /** Append-only, deduped by tool name: tools bound from opened skills. */
+    boundSkillTools: ToolInterface[];
+    /** Rebuild hook wired by createSmartAgent; rebuilds both recovery variants. */
+    __onToolsChanged?: () => void;
+};
+declare function createSkillRegistryRef(): SkillRegistryRef;
+
 type ImageURL = {
     url: string;
     detail?: 'auto' | 'low' | 'high';
@@ -306,8 +371,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 +410,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";
@@ -546,6 +642,15 @@ type SmartAgentOptions = {
     costEstimator?: AgentOptions["costEstimator"];
     /** See AgentOptions.humanInTheLoop. */
     humanInTheLoop?: HumanInTheLoopOptions;
+    /**
+     * Progressive capability disclosure. When provided, the agent exposes cheap
+     * skill headers in its system prompt and binds a skill's tools on demand via
+     * the built-in open_skill / bind_skill_tools tools. Keeps the bound-tool count
+     * per step small. An empty array is a no-op.
+     */
+    skills?: Skill[];
+    /** Caps/tiering for skill disclosure. Defaults to DEFAULT_SKILL_POLICY. */
+    skillPolicy?: SkillPolicy;
 };
 type AgentRuntimeConfig = {
     name?: string;
@@ -883,6 +988,7 @@ type SmartState = AgentState & {
         steps: PlanStepRecord[];
         lastUpdated?: string;
         adherenceScore?: number;
+        lastReflection?: string;
     } | null;
     planVersion?: number;
     /**
@@ -1417,6 +1523,58 @@ declare function createSmartAgent<TOutput = unknown>(opts: SmartAgentOptions & {
     outputSchema?: ZodSchema<TOutput>;
 }): SmartAgentInstance<TOutput>;
 
+/**
+ * Pure registry helpers for the skill primitive. No I/O, no agent loop — these
+ * are the deterministic core, fully unit-testable on their own.
+ */
+/**
+ * Rebuild BOTH runtime tool-set variants with fresh array references.
+ *
+ * This is the heart of mid-run skill binding. `syncRuntimeTools` swaps between
+ * two PRE-COMPUTED arrays and short-circuits on `currentRuntime.tools ===
+ * nextTools`. So to make newly-bound skill tools take effect we must hand back
+ * NEW array references (breaking the `===` short-circuit) AND include the skill
+ * tools in the recovery variant too (otherwise a recovery-swap iteration would
+ * silently drop them).
+ */
+declare function composeToolSets(input: {
+    base: ToolInterface[];
+    boundSkillTools: ToolInterface[];
+    recoveryTool?: ToolInterface;
+}): {
+    toolsWithoutRecovery: ToolInterface[];
+    toolsWithRecovery: ToolInterface[];
+};
+/**
+ * Append tools to the registry, append-only and deduped by name, honoring the
+ * overall total cap. Returns the tools actually added (may be fewer than asked).
+ */
+declare function appendBoundTools(ref: SkillRegistryRef, newTools: ToolInterface[], policy: Pick<SkillPolicy, "maxBoundToolsTotal">): ToolInterface[];
+/** Precedence guard: may the model open another (not-yet-open) skill? */
+declare function canOpenSkill(ref: SkillRegistryRef, policy: SkillPolicy): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Filter the catalog to skills usable now: available + tier-gated. */
+declare function resolveAvailableSkills(skills: Skill[], opts?: {
+    modelTier?: SkillPolicy["modelTier"];
+}): Promise<Skill[]>;
+/** The cheap header block the model always sees in its system prompt. */
+declare function buildSkillHeaderBlock(skills: Skill[]): string;
+declare function dedupeToolsByName(tools: ToolInterface[]): ToolInterface[];
+
+type SkillToolDeps = {
+    registryRef: SkillRegistryRef;
+    skills: Skill[];
+    policy: SkillPolicy;
+};
+declare function createOpenSkillTool(deps: SkillToolDeps): ToolInterface;
+declare function createBindSkillToolsTool(deps: SkillToolDeps): ToolInterface;
+/** Both skill tools for an invoke, sharing one registry ref. */
+declare function createSkillTools(deps: SkillToolDeps): ToolInterface[];
+
 type EvalHarnessParams = {
     profiles: EvalProfileTarget[];
     cases: EvalCase[];
@@ -1729,6 +1887,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 +1972,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 +2067,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 +2077,8 @@ type ChatCompletionChunk = {
     delta: {
         content?: string;
         toolCalls?: Partial<ToolCall>[];
+        /** Incremental reasoning text / signature deltas (Anthropic thinking). */
+        reasoning?: ReasoningPayload;
     };
     usage?: TokenUsage;
     finishReason?: FinishReason;
@@ -1988,9 +2206,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 +2253,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 +2354,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, DEFAULT_SKILL_POLICY, 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, SMALL_TIER_SKILL_POLICY, type SerializableSmartState, type Skill, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillToolDeps, type SkillToolHeader, 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, appendBoundTools, buildSkillHeaderBlock, buildSystemPrompt, canOpenSkill, captureSnapshot, codePresenceRule, cognipeerSink, composeToolSets, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createOpenSkillTool, createProvider, createRegexGuardrail, createResolverNode, createSkillRegistryRef, createSkillTools, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveAvailableSkills, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, setTokenCounter, startStreamingSession, traceSessionToOtlp, validateReasoningConfig, withTools, writeSummaryFactsToMemory };