@cognipeer/agent-sdk 0.8.5 → 0.8.7

package/dist/index.d.cts

@@ -454,6 +454,14 @@ interface ToolInterface<TInput = any, TOutput = any, TCallOptions = any> {
     approvalPrompt?: string;
     approvalDefaults?: any;
     maxExecutionsPerRun?: number | null;
+    /**
+     * Context-retention hint declared by the tool author: what the summarizer may do
+     * to this tool's arguments and response under context pressure. The tool author
+     * knows whether the arguments are the payload (a file write) or just identity (a
+     * lookup); a global policy cannot. A caller-supplied
+     * `toolResponses.retentionByTool[name]` still overrides this per axis.
+     */
+    retention?: ToolRetentionSpec;
     [key: string]: any;
 }
 type RunnableConfig = {
@@ -729,6 +737,37 @@ type RuntimeProfile = BuiltInRuntimeProfile | "custom";
 type SummarizationMode = "incremental" | "full_rewrite";
 type ContextPolicy = "raw" | "summary_only" | "hybrid";
 type ToolResponseRetentionPolicy = "keep_full" | "keep_structured" | "summarize_archive" | "drop";
+/**
+ * Retention policy for a tool call's ARGUMENTS (the `tool_use` input), applied by
+ * the summarizer when it compacts an old exchange.
+ *
+ * - `keep`   — arguments are never modified. The safe default, and correct for the
+ *              overwhelming majority of tools whose arguments are identity/query
+ *              data (ids, paths, queries, flags).
+ * - `digest` — oversized *string fields only* are replaced with a compact
+ *              `{__digest:{chars,sha256,head,executionId}}` descriptor. Every small
+ *              scalar (path, id, mode, index) survives verbatim, so the model can
+ *              still say what it did — it just cannot re-read the payload. The
+ *              original arguments stay in `toolHistory` and are retrievable with
+ *              `get_tool_response({executionId, part:"input"})`.
+ *
+ * Reach for `digest` on content-authoring tools whose arguments carry the payload
+ * (file writes, document chunks, generated code/HTML). Those are the calls where
+ * archiving the *response* frees nothing, because the bulk was in the request.
+ */
+type ToolInputRetentionPolicy = "keep" | "digest";
+/**
+ * Two-axis context retention for a single tool. Input and output are independent
+ * because value density is per-tool: a file-write tool carries its payload in the
+ * arguments and returns `{ok:true}`, while a search tool carries a short query and
+ * returns the bulk. One axis cannot serve both.
+ */
+type ToolRetentionSpec = {
+    /** Argument retention. Defaults to `toolResponses.defaultInputPolicy` ("keep"). */
+    input?: ToolInputRetentionPolicy;
+    /** Response retention. Defaults to `toolResponses.defaultPolicy`. */
+    output?: ToolResponseRetentionPolicy;
+};
 type ToolResponseClassification = "critical" | "informative" | "verbose";
 type PlanningMode = "off" | "todo" | "planner_executor" | "reasoning_then_tools";
 type ReplanPolicy = "never" | "on_failure" | "on_conflict" | "every_n_steps";
@@ -851,10 +890,43 @@ type SmartAgentToolResponseConfig = {
     /**
      * Per-tool override of the summarizer retention policy. Wins over `defaultPolicy`.
      * Critical tools cannot be reduced regardless of override.
+     *
+     * @deprecated Prefer `retentionByTool`, which also covers argument retention.
+     * Still fully honored: it is consulted for the output axis after `retentionByTool`.
      */
     toolResponseRetentionByTool?: Record<string, ToolResponseRetentionPolicy>;
+    /**
+     * Retention policy applied to a tool call's ARGUMENTS when no per-tool policy is
+     * set. Defaults to `"keep"` — argument digesting is strictly opt-in, so enabling
+     * it is always a deliberate per-tool (or per-agent) decision.
+     */
+    defaultInputPolicy?: ToolInputRetentionPolicy;
+    /**
+     * Two-axis per-tool retention override, keyed by tool name. Wins over the tool
+     * definition's own `retention` and over the axis defaults. Either axis may be
+     * omitted to fall through to the next source.
+     *
+     * ```ts
+     * retentionByTool: {
+     *   create_text_file: { input: "digest", output: "summarize_archive" },
+     *   read_skills:      { output: "keep_full" },
+     * }
+     * ```
+     */
+    retentionByTool?: Record<string, ToolRetentionSpec>;
     /** Tool names whose responses are never reduced by the summarizer or hard cap. */
     criticalTools?: string[];
+    /**
+     * Per-field character threshold for argument digesting. A string argument field
+     * longer than this is replaced by a digest descriptor; shorter fields, and every
+     * non-string scalar, are preserved verbatim. Defaults to 2000.
+     */
+    maxToolInputFieldChars?: number;
+    /**
+     * How many leading characters of a digested field to keep as a human/model
+     * readable preview. Defaults to 200.
+     */
+    maxToolInputDigestHeadChars?: number;
     /** Controls whether Zod-backed tool schemas fail fast or warn on invalid args. */
     schemaValidation?: "strict" | "warn";
 };
@@ -1787,7 +1859,7 @@ type ToolRetryPolicy = {
      */
     circuitBreakerThreshold?: number;
 };
-declare function createTool({ name, description, schema, func, needsApproval, approvalPrompt, approvalDefaults, maxExecutionsPerRun, cache, retry, }: {
+declare function createTool({ name, description, schema, func, needsApproval, approvalPrompt, approvalDefaults, maxExecutionsPerRun, cache, retry, retention, }: {
     name: string;
     description?: string;
     schema: ZodSchema;
@@ -1800,6 +1872,13 @@ declare function createTool({ name, description, schema, func, needsApproval, ap
     cache?: boolean | ToolCachePolicy;
     /** Per-tool retry + circuit-breaker policy. */
     retry?: ToolRetryPolicy;
+    /**
+     * Two-axis context-retention hint: what the summarizer may do to this tool's
+     * arguments and response under context pressure. Declare `input: "digest"` on
+     * tools whose arguments carry a bulk payload (document/file content, generated
+     * code) so compaction can reclaim it; leave it unset for identity/query tools.
+     */
+    retention?: ToolRetentionSpec;
 }): ToolInterface;
 
 declare function buildSystemPrompt(extra?: string, planning?: boolean | PlanningMode, name?: string, todoListPrompt?: string): string;
@@ -1882,6 +1961,7 @@ type ContextToolsStateRef = {
 declare function hasToolResponseRecoveryReference(messages: Array<{
     role?: string;
     content?: unknown;
+    tool_calls?: unknown;
 }> | undefined, executionId?: string): boolean;
 declare function createManageTodoTool(stateRef: ContextToolsStateRef): ToolInterface<any, any, any>;
 declare function createGetToolResponseTool(stateRef: ContextToolsStateRef): ToolInterface<any, any, any>;
@@ -2571,6 +2651,114 @@ type ResolvedReasoning = {
 declare function validateReasoningConfig(input: ReasoningConfig | undefined): void;
 declare function resolveReasoning(input: ReasoningConfig | undefined): ResolvedReasoning | undefined;
 
+/**
+ * Tools the agent loop uses to steer ITSELF. Their arguments are never digested —
+ * digesting them is never a win (the arguments are small) and always a risk:
+ *  - `response` carries the run's final structured output,
+ *  - `manage_todo_list` carries the living plan,
+ *  - `ask_user_question` carries the question the user's answer replies to,
+ *  - `open_skill` / `bind_skill_tools` / `search_skills` name the capability being
+ *    loaded, which the rest of the run reasons about,
+ *  - `get_tool_response` is the recovery path itself.
+ * They also default to `keep_full` on the output axis (overridable per tool).
+ */
+declare const CONTROL_PLANE_TOOL_NAMES: readonly string[];
+/**
+ * Delegation tools: the arguments ARE the brief handed to the child agent — the
+ * parent must be able to say what it delegated. Never digested. The child's report
+ * (the output) may still be archived and paged back in.
+ */
+declare const DELEGATION_TOOL_NAMES: readonly string[];
+declare const DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS = 2000;
+declare const DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS = 200;
+/** Key marking a digested argument field. Recognized as a recovery reference. */
+declare const TOOL_INPUT_DIGEST_KEY = "__digest";
+/**
+ * Compact textual preview of a value for archive/structured retention. Used by
+ * the summarizer when an old tool response is reduced to a placeholder. Not
+ * used at tool execution time.
+ */
+declare function summarizeObject(value: any): string;
+/**
+ * Tool-definition-declared retention specs, keyed by tool name. Built from the
+ * runtime's live tool list so a skill-bound tool contributes its own declaration.
+ */
+type ToolRetentionDeclarations = Map<string, ToolRetentionSpec>;
+declare function collectToolRetentionDeclarations(tools: Array<ToolInterface<any, any, any>> | undefined): ToolRetentionDeclarations;
+/**
+ * Resolves the retention policy applied by the summarizer when context limits
+ * are reached. Critical tools are never reduced.
+ *
+ * Precedence (first match wins):
+ *  1. `criticalTools` — absolute, never reduced (documented contract).
+ *  2. `toolResponses.retentionByTool[name].output` — caller's two-axis override.
+ *  3. `toolResponses.toolResponseRetentionByTool[name]` — legacy single-axis map.
+ *  4. the tool definition's own `retention.output`.
+ *  5. built-in control-plane default (`keep_full`).
+ *  6. `toolResponses.defaultPolicy`.
+ */
+declare function resolveSummarizationRetention(toolName: string, config: ResolvedSmartAgentConfig, declarations?: ToolRetentionDeclarations): ToolResponseRetentionPolicy;
+/**
+ * Resolves the retention policy applied to a tool call's ARGUMENTS.
+ *
+ * Precedence (first match wins):
+ *  1. control-plane + delegation tools — always `keep` (hard invariant).
+ *  2. `criticalTools` — a tool whose response may never be reduced does not get
+ *     its request reduced either.
+ *  3. `toolResponses.retentionByTool[name].input`.
+ *  4. the tool definition's own `retention.input`.
+ *  5. `toolResponses.defaultInputPolicy` (defaults to `keep`).
+ *
+ * The default is `keep`, so argument digesting never happens unless a tool or a
+ * caller explicitly asks for it.
+ */
+declare function resolveInputRetention(toolName: string, config: ResolvedSmartAgentConfig, declarations?: ToolRetentionDeclarations): ToolInputRetentionPolicy;
+type ToolInputDigestOptions = {
+    /** Per-field character threshold. Strings at or below this are preserved verbatim. */
+    maxFieldChars?: number;
+    /** Leading characters of a digested field kept as a preview. */
+    headChars?: number;
+    /** Execution id embedded in each marker so the model can page the original back in. */
+    executionId?: string;
+};
+type ToolInputDigestResult = {
+    /** The rewritten value. Identical reference when nothing was digested. */
+    value: unknown;
+    /** Dotted paths of the fields that were replaced by a digest marker. */
+    digestedPaths: string[];
+    /** Characters reclaimed from the serialized arguments. */
+    reclaimedChars: number;
+};
+/**
+ * Field-level argument digest.
+ *
+ * Walks the argument structure and replaces ONLY string leaves longer than
+ * `maxFieldChars` with a compact descriptor. Every other field — paths, ids,
+ * modes, indexes, booleans, short strings — is preserved verbatim, so a call like
+ *
+ *   { filePath: "/reports/q3.md", mode: "append", section: 3, content: "<60k>" }
+ *
+ * compacts to
+ *
+ *   { filePath: "/reports/q3.md", mode: "append", section: 3,
+ *     content: { __digest: { chars: 61840, sha256: "…", head: "# Q3 …", recover: "…" } } }
+ *
+ * The model can still state exactly what it did; only the payload it no longer
+ * needs to re-read is gone. Idempotent: an existing digest marker is left alone.
+ */
+declare function digestToolInputValue(value: unknown, options?: ToolInputDigestOptions): ToolInputDigestResult;
+/**
+ * Digest a serialized `tool_call.function.arguments` JSON string in place.
+ * Returns the input string unchanged when nothing needed digesting, when the
+ * string is not parseable JSON (never guess at a non-JSON payload), or when the
+ * result would not actually be smaller.
+ */
+declare function digestToolInputArguments(argumentsJson: string, options?: ToolInputDigestOptions): {
+    arguments: string;
+    digestedPaths: string[];
+    reclaimedChars: number;
+};
+
 declare function fileSink(path?: string): TraceSinkConfig;
 type CustomSinkArg = ((event: TraceEventRecord) => void | Promise<void>) | {
     onEvent?: (event: TraceEventRecord) => void | Promise<void>;
@@ -3070,4 +3258,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
  */
 declare function createProvider(config: ProviderConfig): BaseProvider;
 
-export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type AudioContent, 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 FileContent, 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, type ImageContent, 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 SkillDisclosure, 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 TextContent, 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, createSearchSkillsTool, 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, searchSkills, seedChildMessages, selectTopIndicesInOrder, setTokenCounter, startStreamingSession, tokenize, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, writeSummaryFactsToMemory };
+export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type AudioContent, 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, CONTROL_PLANE_TOOL_NAMES, 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_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, 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, type ImageContent, 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 SkillDisclosure, 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, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, 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, collectToolRetentionDeclarations, 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, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, 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, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, setTokenCounter, startStreamingSession, summarizeObject, tokenize, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, writeSummaryFactsToMemory };

package/dist/index.d.ts

@@ -454,6 +454,14 @@ interface ToolInterface<TInput = any, TOutput = any, TCallOptions = any> {
     approvalPrompt?: string;
     approvalDefaults?: any;
     maxExecutionsPerRun?: number | null;
+    /**
+     * Context-retention hint declared by the tool author: what the summarizer may do
+     * to this tool's arguments and response under context pressure. The tool author
+     * knows whether the arguments are the payload (a file write) or just identity (a
+     * lookup); a global policy cannot. A caller-supplied
+     * `toolResponses.retentionByTool[name]` still overrides this per axis.
+     */
+    retention?: ToolRetentionSpec;
     [key: string]: any;
 }
 type RunnableConfig = {
@@ -729,6 +737,37 @@ type RuntimeProfile = BuiltInRuntimeProfile | "custom";
 type SummarizationMode = "incremental" | "full_rewrite";
 type ContextPolicy = "raw" | "summary_only" | "hybrid";
 type ToolResponseRetentionPolicy = "keep_full" | "keep_structured" | "summarize_archive" | "drop";
+/**
+ * Retention policy for a tool call's ARGUMENTS (the `tool_use` input), applied by
+ * the summarizer when it compacts an old exchange.
+ *
+ * - `keep`   — arguments are never modified. The safe default, and correct for the
+ *              overwhelming majority of tools whose arguments are identity/query
+ *              data (ids, paths, queries, flags).
+ * - `digest` — oversized *string fields only* are replaced with a compact
+ *              `{__digest:{chars,sha256,head,executionId}}` descriptor. Every small
+ *              scalar (path, id, mode, index) survives verbatim, so the model can
+ *              still say what it did — it just cannot re-read the payload. The
+ *              original arguments stay in `toolHistory` and are retrievable with
+ *              `get_tool_response({executionId, part:"input"})`.
+ *
+ * Reach for `digest` on content-authoring tools whose arguments carry the payload
+ * (file writes, document chunks, generated code/HTML). Those are the calls where
+ * archiving the *response* frees nothing, because the bulk was in the request.
+ */
+type ToolInputRetentionPolicy = "keep" | "digest";
+/**
+ * Two-axis context retention for a single tool. Input and output are independent
+ * because value density is per-tool: a file-write tool carries its payload in the
+ * arguments and returns `{ok:true}`, while a search tool carries a short query and
+ * returns the bulk. One axis cannot serve both.
+ */
+type ToolRetentionSpec = {
+    /** Argument retention. Defaults to `toolResponses.defaultInputPolicy` ("keep"). */
+    input?: ToolInputRetentionPolicy;
+    /** Response retention. Defaults to `toolResponses.defaultPolicy`. */
+    output?: ToolResponseRetentionPolicy;
+};
 type ToolResponseClassification = "critical" | "informative" | "verbose";
 type PlanningMode = "off" | "todo" | "planner_executor" | "reasoning_then_tools";
 type ReplanPolicy = "never" | "on_failure" | "on_conflict" | "every_n_steps";
@@ -851,10 +890,43 @@ type SmartAgentToolResponseConfig = {
     /**
      * Per-tool override of the summarizer retention policy. Wins over `defaultPolicy`.
      * Critical tools cannot be reduced regardless of override.
+     *
+     * @deprecated Prefer `retentionByTool`, which also covers argument retention.
+     * Still fully honored: it is consulted for the output axis after `retentionByTool`.
      */
     toolResponseRetentionByTool?: Record<string, ToolResponseRetentionPolicy>;
+    /**
+     * Retention policy applied to a tool call's ARGUMENTS when no per-tool policy is
+     * set. Defaults to `"keep"` — argument digesting is strictly opt-in, so enabling
+     * it is always a deliberate per-tool (or per-agent) decision.
+     */
+    defaultInputPolicy?: ToolInputRetentionPolicy;
+    /**
+     * Two-axis per-tool retention override, keyed by tool name. Wins over the tool
+     * definition's own `retention` and over the axis defaults. Either axis may be
+     * omitted to fall through to the next source.
+     *
+     * ```ts
+     * retentionByTool: {
+     *   create_text_file: { input: "digest", output: "summarize_archive" },
+     *   read_skills:      { output: "keep_full" },
+     * }
+     * ```
+     */
+    retentionByTool?: Record<string, ToolRetentionSpec>;
     /** Tool names whose responses are never reduced by the summarizer or hard cap. */
     criticalTools?: string[];
+    /**
+     * Per-field character threshold for argument digesting. A string argument field
+     * longer than this is replaced by a digest descriptor; shorter fields, and every
+     * non-string scalar, are preserved verbatim. Defaults to 2000.
+     */
+    maxToolInputFieldChars?: number;
+    /**
+     * How many leading characters of a digested field to keep as a human/model
+     * readable preview. Defaults to 200.
+     */
+    maxToolInputDigestHeadChars?: number;
     /** Controls whether Zod-backed tool schemas fail fast or warn on invalid args. */
     schemaValidation?: "strict" | "warn";
 };
@@ -1787,7 +1859,7 @@ type ToolRetryPolicy = {
      */
     circuitBreakerThreshold?: number;
 };
-declare function createTool({ name, description, schema, func, needsApproval, approvalPrompt, approvalDefaults, maxExecutionsPerRun, cache, retry, }: {
+declare function createTool({ name, description, schema, func, needsApproval, approvalPrompt, approvalDefaults, maxExecutionsPerRun, cache, retry, retention, }: {
     name: string;
     description?: string;
     schema: ZodSchema;
@@ -1800,6 +1872,13 @@ declare function createTool({ name, description, schema, func, needsApproval, ap
     cache?: boolean | ToolCachePolicy;
     /** Per-tool retry + circuit-breaker policy. */
     retry?: ToolRetryPolicy;
+    /**
+     * Two-axis context-retention hint: what the summarizer may do to this tool's
+     * arguments and response under context pressure. Declare `input: "digest"` on
+     * tools whose arguments carry a bulk payload (document/file content, generated
+     * code) so compaction can reclaim it; leave it unset for identity/query tools.
+     */
+    retention?: ToolRetentionSpec;
 }): ToolInterface;
 
 declare function buildSystemPrompt(extra?: string, planning?: boolean | PlanningMode, name?: string, todoListPrompt?: string): string;
@@ -1882,6 +1961,7 @@ type ContextToolsStateRef = {
 declare function hasToolResponseRecoveryReference(messages: Array<{
     role?: string;
     content?: unknown;
+    tool_calls?: unknown;
 }> | undefined, executionId?: string): boolean;
 declare function createManageTodoTool(stateRef: ContextToolsStateRef): ToolInterface<any, any, any>;
 declare function createGetToolResponseTool(stateRef: ContextToolsStateRef): ToolInterface<any, any, any>;
@@ -2571,6 +2651,114 @@ type ResolvedReasoning = {
 declare function validateReasoningConfig(input: ReasoningConfig | undefined): void;
 declare function resolveReasoning(input: ReasoningConfig | undefined): ResolvedReasoning | undefined;
 
+/**
+ * Tools the agent loop uses to steer ITSELF. Their arguments are never digested —
+ * digesting them is never a win (the arguments are small) and always a risk:
+ *  - `response` carries the run's final structured output,
+ *  - `manage_todo_list` carries the living plan,
+ *  - `ask_user_question` carries the question the user's answer replies to,
+ *  - `open_skill` / `bind_skill_tools` / `search_skills` name the capability being
+ *    loaded, which the rest of the run reasons about,
+ *  - `get_tool_response` is the recovery path itself.
+ * They also default to `keep_full` on the output axis (overridable per tool).
+ */
+declare const CONTROL_PLANE_TOOL_NAMES: readonly string[];
+/**
+ * Delegation tools: the arguments ARE the brief handed to the child agent — the
+ * parent must be able to say what it delegated. Never digested. The child's report
+ * (the output) may still be archived and paged back in.
+ */
+declare const DELEGATION_TOOL_NAMES: readonly string[];
+declare const DEFAULT_MAX_TOOL_INPUT_FIELD_CHARS = 2000;
+declare const DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS = 200;
+/** Key marking a digested argument field. Recognized as a recovery reference. */
+declare const TOOL_INPUT_DIGEST_KEY = "__digest";
+/**
+ * Compact textual preview of a value for archive/structured retention. Used by
+ * the summarizer when an old tool response is reduced to a placeholder. Not
+ * used at tool execution time.
+ */
+declare function summarizeObject(value: any): string;
+/**
+ * Tool-definition-declared retention specs, keyed by tool name. Built from the
+ * runtime's live tool list so a skill-bound tool contributes its own declaration.
+ */
+type ToolRetentionDeclarations = Map<string, ToolRetentionSpec>;
+declare function collectToolRetentionDeclarations(tools: Array<ToolInterface<any, any, any>> | undefined): ToolRetentionDeclarations;
+/**
+ * Resolves the retention policy applied by the summarizer when context limits
+ * are reached. Critical tools are never reduced.
+ *
+ * Precedence (first match wins):
+ *  1. `criticalTools` — absolute, never reduced (documented contract).
+ *  2. `toolResponses.retentionByTool[name].output` — caller's two-axis override.
+ *  3. `toolResponses.toolResponseRetentionByTool[name]` — legacy single-axis map.
+ *  4. the tool definition's own `retention.output`.
+ *  5. built-in control-plane default (`keep_full`).
+ *  6. `toolResponses.defaultPolicy`.
+ */
+declare function resolveSummarizationRetention(toolName: string, config: ResolvedSmartAgentConfig, declarations?: ToolRetentionDeclarations): ToolResponseRetentionPolicy;
+/**
+ * Resolves the retention policy applied to a tool call's ARGUMENTS.
+ *
+ * Precedence (first match wins):
+ *  1. control-plane + delegation tools — always `keep` (hard invariant).
+ *  2. `criticalTools` — a tool whose response may never be reduced does not get
+ *     its request reduced either.
+ *  3. `toolResponses.retentionByTool[name].input`.
+ *  4. the tool definition's own `retention.input`.
+ *  5. `toolResponses.defaultInputPolicy` (defaults to `keep`).
+ *
+ * The default is `keep`, so argument digesting never happens unless a tool or a
+ * caller explicitly asks for it.
+ */
+declare function resolveInputRetention(toolName: string, config: ResolvedSmartAgentConfig, declarations?: ToolRetentionDeclarations): ToolInputRetentionPolicy;
+type ToolInputDigestOptions = {
+    /** Per-field character threshold. Strings at or below this are preserved verbatim. */
+    maxFieldChars?: number;
+    /** Leading characters of a digested field kept as a preview. */
+    headChars?: number;
+    /** Execution id embedded in each marker so the model can page the original back in. */
+    executionId?: string;
+};
+type ToolInputDigestResult = {
+    /** The rewritten value. Identical reference when nothing was digested. */
+    value: unknown;
+    /** Dotted paths of the fields that were replaced by a digest marker. */
+    digestedPaths: string[];
+    /** Characters reclaimed from the serialized arguments. */
+    reclaimedChars: number;
+};
+/**
+ * Field-level argument digest.
+ *
+ * Walks the argument structure and replaces ONLY string leaves longer than
+ * `maxFieldChars` with a compact descriptor. Every other field — paths, ids,
+ * modes, indexes, booleans, short strings — is preserved verbatim, so a call like
+ *
+ *   { filePath: "/reports/q3.md", mode: "append", section: 3, content: "<60k>" }
+ *
+ * compacts to
+ *
+ *   { filePath: "/reports/q3.md", mode: "append", section: 3,
+ *     content: { __digest: { chars: 61840, sha256: "…", head: "# Q3 …", recover: "…" } } }
+ *
+ * The model can still state exactly what it did; only the payload it no longer
+ * needs to re-read is gone. Idempotent: an existing digest marker is left alone.
+ */
+declare function digestToolInputValue(value: unknown, options?: ToolInputDigestOptions): ToolInputDigestResult;
+/**
+ * Digest a serialized `tool_call.function.arguments` JSON string in place.
+ * Returns the input string unchanged when nothing needed digesting, when the
+ * string is not parseable JSON (never guess at a non-JSON payload), or when the
+ * result would not actually be smaller.
+ */
+declare function digestToolInputArguments(argumentsJson: string, options?: ToolInputDigestOptions): {
+    arguments: string;
+    digestedPaths: string[];
+    reclaimedChars: number;
+};
+
 declare function fileSink(path?: string): TraceSinkConfig;
 type CustomSinkArg = ((event: TraceEventRecord) => void | Promise<void>) | {
     onEvent?: (event: TraceEventRecord) => void | Promise<void>;
@@ -3070,4 +3258,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
  */
 declare function createProvider(config: ProviderConfig): BaseProvider;
 
-export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type AudioContent, 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 FileContent, 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, type ImageContent, 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 SkillDisclosure, 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 TextContent, 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, createSearchSkillsTool, 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, searchSkills, seedChildMessages, selectTopIndicesInOrder, setTokenCounter, startStreamingSession, tokenize, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, writeSummaryFactsToMemory };
+export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, type AudioContent, 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, CONTROL_PLANE_TOOL_NAMES, 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_MAX_TOOL_INPUT_FIELD_CHARS, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, DEFAULT_TOOL_INPUT_DIGEST_HEAD_CHARS, DELEGATION_TOOL_NAMES, DedupTracker, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FileContent, 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, type ImageContent, 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 SkillDisclosure, 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, TOOL_INPUT_DIGEST_KEY, type TextContent, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, 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, collectToolRetentionDeclarations, 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, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, 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, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, setTokenCounter, startStreamingSession, summarizeObject, tokenize, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, writeSummaryFactsToMemory };