@cognipeer/agent-sdk 0.8.0 → 0.8.2

package/dist/index.d.ts

@@ -302,6 +302,110 @@ type SkillRegistryRef = {
 };
 declare function createSkillRegistryRef(): SkillRegistryRef;
 
+type ContextPilotJsonCompressionConfig = {
+    enabled?: boolean;
+    /** Fraction (0-1) of array items to retain. Lower = more aggressive. */
+    targetRatio?: number;
+    /** Minimum array length before compression is even considered. */
+    minItems?: number;
+};
+type ContextPilotTextCompressionConfig = {
+    enabled?: boolean;
+    /** Fraction (0-1) of sentences to retain. */
+    targetRatio?: number;
+    /** Minimum character length before compression is even considered. */
+    minChars?: number;
+};
+type ContextPilotDiffCompressionConfig = {
+    enabled?: boolean;
+    /** Number of unchanged context lines to keep around each hunk boundary. */
+    contextLines?: number;
+};
+type ContextPilotLogCompressionConfig = {
+    enabled?: boolean;
+    /** Maximum number of retained lines after scoring. */
+    maxLines?: number;
+};
+type ContextPilotSearchCompressionConfig = {
+    enabled?: boolean;
+    /** Maximum number of retained match lines. */
+    maxMatches?: number;
+};
+type ContextPilotCompressionConfig = {
+    json?: ContextPilotJsonCompressionConfig;
+    text?: ContextPilotTextCompressionConfig;
+    diff?: ContextPilotDiffCompressionConfig;
+    log?: ContextPilotLogCompressionConfig;
+    search?: ContextPilotSearchCompressionConfig;
+};
+type ContextPilotCCRConfig = {
+    enabled?: boolean;
+    /** Time-to-live for stored originals, in milliseconds. */
+    ttlMs?: number;
+    /** Maximum number of entries kept in the reversible store (oldest evicted first). */
+    maxEntries?: number;
+};
+type ContextPilotCacheAlignmentConfig = {
+    enabled?: boolean;
+    /** Emit a one-time warning (event + trace) when volatile content is detected in the system prompt. */
+    warnOnVolatilePrompt?: boolean;
+};
+type ContextPilotDedupConfig = {
+    enabled?: boolean;
+    /** Minimum serialized size (chars) before a tool output is eligible for cross-turn dedup. */
+    minChars?: number;
+};
+/**
+ * ContextPilot: native context/token optimization layer.
+ *
+ * Runs deterministically (no extra model calls) at tool-execution time to
+ * shrink large tool outputs before they enter the transcript, while keeping
+ * every original payload recoverable via `get_tool_response`.
+ */
+type ContextPilotConfig = {
+    enabled?: boolean;
+    compression?: ContextPilotCompressionConfig;
+    ccr?: ContextPilotCCRConfig;
+    cacheAlignment?: ContextPilotCacheAlignmentConfig;
+    dedup?: ContextPilotDedupConfig;
+    /** Tool names that should never be processed by ContextPilot. */
+    excludeTools?: string[];
+};
+type ResolvedContextPilotConfig = {
+    enabled: boolean;
+    compression: {
+        json: Required<ContextPilotJsonCompressionConfig>;
+        text: Required<ContextPilotTextCompressionConfig>;
+        diff: Required<ContextPilotDiffCompressionConfig>;
+        log: Required<ContextPilotLogCompressionConfig>;
+        search: Required<ContextPilotSearchCompressionConfig>;
+    };
+    ccr: Required<ContextPilotCCRConfig>;
+    cacheAlignment: Required<ContextPilotCacheAlignmentConfig>;
+    dedup: Required<ContextPilotDedupConfig>;
+    excludeTools: string[];
+};
+type ContextPilotCompressorKind = "jsonCrusher" | "textCrusher" | "diffCompressor" | "logCompressor" | "searchCompressor" | "none";
+type ContextPilotCompressionStats = {
+    applied: boolean;
+    compressorUsed: ContextPilotCompressorKind;
+    originalTokens: number;
+    compressedTokens: number;
+    droppedItems?: number;
+    ccrHash?: string;
+    /** Set when this output was recognized as a cross-turn duplicate instead of compressed. */
+    duplicateOf?: string;
+};
+type ContextPilotResult = ContextPilotCompressionStats & {
+    output: unknown;
+};
+type VolatileContentPattern = "uuid" | "iso8601" | "unix_timestamp" | "jwt" | "hex_hash" | "api_key";
+type VolatileContentFinding = {
+    pattern: VolatileContentPattern;
+    match: string;
+    index: number;
+};
+
 type ImageURL = {
     url: string;
     detail?: 'auto' | 'low' | 'high';
@@ -453,6 +557,19 @@ type TracingConfig = {
     logData?: boolean;
     sink?: TraceSinkConfig;
     threadId?: string;
+    /**
+     * Optional caller-supplied session id. When set, the trace session is keyed
+     * by this value instead of an auto-generated `sess_…` id, so the emitted
+     * traces can be correlated with the caller's own run/task/chat identifiers.
+     * When omitted, a random session id is generated (previous behavior).
+     */
+    sessionId?: string;
+    /**
+     * Optional display name for the agent that owns this trace session. Overrides
+     * the SmartAgent's own `name` in the emitted session/start payload — useful
+     * when the same agent implementation runs under several logical names.
+     */
+    agentName?: string;
 };
 type SmartAgentTracingConfig = TracingConfig;
 type AgentOptions = {
@@ -500,6 +617,15 @@ type AgentOptions = {
      * questions for the host application to answer.
      */
     humanInTheLoop?: HumanInTheLoopOptions;
+    /**
+     * ContextPilot: native, deterministic context/token optimization layer.
+     * Compresses large tool outputs (JSON arrays, logs, diffs, search results,
+     * long text) at execution time using relevance scoring, while keeping every
+     * original payload recoverable via `get_tool_response`. **Opt-in** — disabled
+     * unless `contextPilot: { enabled: true }` (or an equivalent override) is
+     * passed explicitly.
+     */
+    contextPilot?: ContextPilotConfig;
 };
 type ReasoningLevel = "minimal" | "low" | "medium" | "high";
 type ReflectionCadence = "off" | "every_turn" | "after_tool" | "on_branch" | "initial_then_after_tool";
@@ -721,6 +847,7 @@ type SmartAgentCustomProfileConfig = {
     memory?: SmartAgentMemoryConfig;
     delegation?: SmartAgentDelegationConfig;
     toolResponses?: SmartAgentToolResponseConfig;
+    contextPilot?: ContextPilotConfig;
 };
 type ProfileConfig = {
     limits: Required<AgentLimits>;
@@ -734,6 +861,7 @@ type ProfileConfig = {
     };
     delegation: Required<SmartAgentDelegationConfig>;
     toolResponses: Required<SmartAgentToolResponseConfig>;
+    contextPilot: ResolvedContextPilotConfig;
 };
 type ResolvedSmartAgentConfig = ProfileConfig & {
     runtimeProfile: RuntimeProfile;
@@ -755,6 +883,11 @@ type SmartAgentOptions = {
     planning?: SmartAgentPlanningConfig;
     delegation?: SmartAgentDelegationConfig;
     toolResponses?: SmartAgentToolResponseConfig;
+    /**
+     * ContextPilot: native, deterministic context/token optimization layer.
+     * See `AgentOptions.contextPilot` for details. **Opt-in** — disabled by default.
+     */
+    contextPilot?: ContextPilotConfig;
     systemPrompt?: string;
     todoListPrompt?: string;
     /** @deprecated Use planning.mode="todo" */
@@ -1068,6 +1201,8 @@ type TraceSessionRuntime = {
         model?: string;
         provider?: string;
     };
+    /** Caller-supplied agent name override (from TracingConfig.agentName). */
+    configAgentName?: string;
     resolvedConfig: ResolvedTraceConfig;
     events: TraceEventRecord[];
     summary: TraceSessionSummary;
@@ -1105,6 +1240,8 @@ type AgentState = {
         archiveId?: string;
         summary?: string;
         status?: "success" | "error" | "rejected" | "handoff";
+        /** Set when ContextPilot compressed this tool's output before it entered the transcript. */
+        contextPilot?: ContextPilotCompressionStats;
     }>;
     toolCache?: Record<string, any>;
     toolCallCount?: number;
@@ -1714,6 +1851,7 @@ type ContextToolsStateRef = {
         role?: string;
         content?: unknown;
     }>;
+    ctx?: Record<string, any>;
 };
 declare function hasToolResponseRecoveryReference(messages: Array<{
     role?: string;
@@ -1954,6 +2092,109 @@ declare function getResolvedSmartConfig(opts: SmartAgentOptions, runtime?: {
     smart?: ResolvedSmartAgentConfig | undefined;
 }): ResolvedSmartAgentConfig;
 
+/** Unicode-aware tokenizer: splits on non-word boundaries so it works for Turkish, CJK, etc. */
+declare function tokenize(text: string): string[];
+type Bm25Params = {
+    k1?: number;
+    b?: number;
+};
+/**
+ * Scores each document in `docs` against `query` using BM25. When `query` is
+ * empty, every document gets a neutral score of 1 (callers should then rely
+ * on their own tie-break, e.g. recency or original order).
+ */
+declare function scoreItemsByRelevance(docs: string[], query: string, params?: Bm25Params): number[];
+/** Ranks items by score (desc), keeps the top `count`, then restores original order. */
+declare function selectTopIndicesInOrder(scores: number[], count: number): number[];
+
+declare class CCRStore {
+    private entries;
+    private readonly defaultTtlMs;
+    private readonly maxEntries;
+    constructor(options?: {
+        ttlMs?: number;
+        maxEntries?: number;
+    });
+    /** Stores `value` and returns a short content hash that can be used to retrieve it later. */
+    store(value: unknown, ttlMs?: number): string;
+    /** Returns the original value for `hash`, or `undefined` if missing/expired. */
+    retrieve(hash: string): unknown | undefined;
+    has(hash: string): boolean;
+    get size(): number;
+    private evictIfNeeded;
+    static hashOf(value: unknown): string;
+}
+
+type DedupEntry = {
+    executionId: string;
+    toolName: string;
+};
+declare class DedupTracker {
+    private seen;
+    /**
+     * Registers `content` under `executionId`/`toolName`. Returns the entry
+     * that first produced this exact content, or `undefined` if this is the
+     * first time it has been seen.
+     */
+    checkAndRegister(content: string, executionId: string, toolName: string): DedupEntry | undefined;
+}
+
+/**
+ * Scans `text` for volatile content and returns up to `limit` findings.
+ * Cheap regex-only detection, no ML, safe to call on every system prompt.
+ */
+declare function detectVolatileContent(text: string, limit?: number): VolatileContentFinding[];
+
+declare const CONTEXT_PILOT_JSON_MARKER_KEY = "__contextPilotDropped";
+declare function compressJsonOutput(output: unknown, query: string, config: Required<ContextPilotJsonCompressionConfig>, ccrStore: CCRStore): ContextPilotResult;
+
+declare function compressTextOutput(text: string, query: string, config: Required<ContextPilotTextCompressionConfig>, ccrStore: CCRStore): ContextPilotResult;
+
+/** Cheap content-shape detector used to route a text tool output to the right compressor. */
+declare function detectTextFormat(text: string): "diff" | "log" | "search" | "text";
+/**
+ * Keeps hunk headers and every added/removed line verbatim, trims unchanged
+ * context lines beyond `contextLines` around each hunk boundary.
+ */
+declare function compressDiffOutput(text: string, config: Required<ContextPilotDiffCompressionConfig>, ccrStore: CCRStore): ContextPilotResult;
+/**
+ * Scores each line by log-level keywords (errors/failures always win) and
+ * keeps the top `maxLines`, always preserving the first and last line.
+ */
+declare function compressLogOutput(text: string, config: Required<ContextPilotLogCompressionConfig>, ccrStore: CCRStore): ContextPilotResult;
+/**
+ * Keeps up to `maxMatches` grep/ripgrep-style match lines (`file:line:content`
+ * or `file-line-content`), biased towards file diversity via a soft per-file cap.
+ */
+declare function compressSearchOutput(text: string, config: Required<ContextPilotSearchCompressionConfig>, ccrStore: CCRStore): ContextPilotResult;
+
+type ContextPilotRuntime = {
+    ccrStore: CCRStore;
+    dedupTracker: DedupTracker;
+};
+/** Creates a fresh (per-invoke) runtime: CCR store + dedup tracker. */
+declare function createContextPilotRuntime(config: ResolvedContextPilotConfig): ContextPilotRuntime;
+/** Extracts the latest user message text, used as the relevance query for compression scoring. */
+declare function extractLatestUserQuery(messages: BaseMessage[] | undefined): string;
+type CompressToolOutputParams = {
+    toolName: string;
+    output: unknown;
+    query: string;
+    executionId: string;
+    config: ResolvedContextPilotConfig;
+    runtime: ContextPilotRuntime;
+};
+/**
+ * ContextPilot entry point. Order of operations:
+ *  1. Cross-turn duplicate check (short-circuits with a pointer if identical
+ *     content was already seen in this run).
+ *  2. Non-string (JSON-like) outputs go through the JSON/array compressor.
+ *  3. String outputs are format-sniffed (diff/log/search/plain text) and
+ *     routed to the matching compressor, falling back to generic text
+ *     compression.
+ */
+declare function compressToolOutput(params: CompressToolOutputParams): ContextPilotResult;
+
 type GuardrailEvaluationParams = {
     guardrails?: ConversationGuardrail[];
     phase: GuardrailPhase;
@@ -2589,6 +2830,18 @@ declare class AnthropicProvider extends BaseProvider {
     completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
     private buildRequestBody;
     private splitSystemMessages;
+    /**
+     * Converts unified messages to Anthropic format, coalescing consecutive
+     * tool-result messages into a single `user` turn.
+     *
+     * The unified message list carries one `role: "tool"` entry per tool call
+     * (mirroring OpenAI's shape). Anthropic's Messages API expects every
+     * `tool_result` block answering a single assistant turn's `tool_use`
+     * block(s) to be batched into ONE `user` message rather than sent as
+     * separate consecutive `user` messages.
+     */
+    private toAnthropicMessages;
+    private toAnthropicToolResult;
     private toAnthropicMessage;
     private toAnthropicTool;
     private doFetch;
@@ -2626,6 +2879,19 @@ declare class BedrockProvider extends BaseProvider {
     completeStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
     private buildConverseBody;
     private splitSystemMessages;
+    /**
+     * Converts unified messages to Bedrock Converse format, coalescing
+     * consecutive tool-result messages into a single `user` turn.
+     *
+     * The unified message list carries one `role: "tool"` entry per tool call
+     * (mirroring OpenAI's shape). Bedrock's Converse API requires every
+     * `toolResult` block answering a single assistant turn's `toolUse`
+     * block(s) to be batched into ONE `user` message — sending them as
+     * separate consecutive `user` messages triggers: "Expected toolResult
+     * blocks at messages.N.content for the following Ids: ...".
+     */
+    private toBedrockMessages;
+    private toBedrockToolResult;
     private toBedrockMessage;
     private toBedrockTool;
     private doFetch;
@@ -2647,6 +2913,7 @@ declare class VertexProvider extends BaseProvider {
     private buildUrl;
     private buildGeminiBody;
     private buildContents;
+    private toGeminiFunctionResponsePart;
     private toGeminiContent;
     private toGeminiTool;
     private getAccessToken;
@@ -2704,4 +2971,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 BuildChildConfig, 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, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, type DelegationEventStamp, 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 LoadSkillsOptions, 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 PromptHooks, 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 SkillExecutionContext, type SkillFrontmatter, type SkillFs, 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 SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, 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, buildSubagentCatalogBlock, buildSystemPrompt, canOpenSkill, canSpawn, captureSnapshot, codePresenceRule, cognipeerSink, composeToolSets, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createOpenSkillTool, createParallelTool, createProvider, createRegexGuardrail, createResolverNode, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, loadSkillsFromDisk, normalizeSmartAgentOptions, otlpSink, parseSkillFrontmatter, readMemoryFacts, regexRule, resolveAvailableSkills, resolveAvailableSubagents, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, seedChildMessages, setTokenCounter, startStreamingSession, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, 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 BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONTEXT_PILOT_JSON_MARKER_KEY, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CompressToolOutputParams, type ContextPilotCCRConfig, type ContextPilotCacheAlignmentConfig, type ContextPilotCompressionConfig, type ContextPilotCompressionStats, type ContextPilotCompressorKind, type ContextPilotConfig, type ContextPilotDedupConfig, type ContextPilotDiffCompressionConfig, type ContextPilotJsonCompressionConfig, type ContextPilotLogCompressionConfig, type ContextPilotResult, type ContextPilotRuntime, type ContextPilotSearchCompressionConfig, type ContextPilotTextCompressionConfig, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DedupTracker, type DelegationEventStamp, 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 LoadSkillsOptions, 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 PromptHooks, 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 ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SerializableSmartState, type Skill, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, 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 SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, 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, type VolatileContentFinding, type VolatileContentPattern, agentVerdictRule, appendBoundTools, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, canOpenSkill, canSpawn, captureSnapshot, codePresenceRule, cognipeerSink, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createOpenSkillTool, createParallelTool, createProvider, createRegexGuardrail, createResolverNode, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, detectTextFormat, detectVolatileContent, emptyUsage, evaluateGuardrails, extractLatestUserQuery, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, loadSkillsFromDisk, normalizeSmartAgentOptions, otlpSink, parseSkillFrontmatter, readMemoryFacts, regexRule, resolveAvailableSkills, resolveAvailableSubagents, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, scoreItemsByRelevance, seedChildMessages, selectTopIndicesInOrder, setTokenCounter, startStreamingSession, tokenize, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, writeSummaryFactsToMemory };