@cognipeer/agent-sdk 0.14.0 → 0.16.0

package/dist/index.d.ts

@@ -525,6 +525,25 @@ interface HookMap {
             tokensAfter: number;
             /** Name of the strategy that produced it — `"builtin"` when no slot is filled. */
             strategy: string;
+            /**
+             * The summarizer's own model call — absent when it produced no call (a
+             * local fallback, or a strategy that reports none). It is a real, billed
+             * model call that never passes `pre/postModelCall`, so this is the only
+             * place an observer sees it.
+             */
+            call?: {
+                model?: string;
+                durationMs?: number;
+                usage?: {
+                    inputTokens?: number;
+                    outputTokens?: number;
+                    cachedInputTokens?: number;
+                    totalTokens?: number;
+                };
+                messagesCompressed?: number;
+                /** True when the model call failed and the summary was built locally. */
+                fallback?: boolean;
+            };
         };
         output: void;
     };
@@ -952,23 +971,57 @@ type SubagentPolicy = {
     childContextPolicy: ChildContextPolicy;
     /** Whether ad-hoc spawns may reference the parent's tools by name. */
     allowAdhocTools: boolean;
+    /**
+     * Forward the children's streamed text to the parent's `onStream` / `stream`
+     * events. Off by default: a host that appends `chunk.text` would print every
+     * child's words as if they were the parent's answer. When on, each forwarded
+     * chunk carries `subagentName` / `subagentId`.
+     */
+    streamChildren?: boolean;
 };
 declare const DEFAULT_SUBAGENT_POLICY: SubagentPolicy;
-/** Result of a single sub-agent run (returned to the model as the tool result). */
+/**
+ * How a child run ended.
+ *  - `ok`           — finished and produced an answer.
+ *  - `incomplete`   — stopped early (a limit, the tool-call cap, no answer): `content` is partial.
+ *  - `blocked`      — refused by policy (a `subagentStart` gate or an output guardrail).
+ *  - `needs_input`  — wanted a human (parallel fan-out cannot ask).
+ *  - `cancelled`    — the run was cancelled while the child was working.
+ *  - `error`        — threw, or its structured output failed.
+ */
+type SubagentStatus = "ok" | "incomplete" | "blocked" | "needs_input" | "cancelled" | "error";
+/** Model calls a child made, in the parent's `state.usage` shape. */
+type SubagentUsage = {
+    perRequest: NonNullable<AgentState["usage"]>["perRequest"];
+    totals: NonNullable<AgentState["usage"]>["totals"];
+};
+/**
+ * Result of a single sub-agent run. The model sees a projection of it
+ * (`toModelResult`: no `input`, `usage` or `durationMs`); hosts get the whole
+ * thing on `subagent` events, `subagentStop` observers and the registry.
+ */
 type SubagentResult = {
     /** Sub-agent name (registry) or role (ad-hoc). */
     name: string;
     mode: "registry" | "adhoc";
-    /** The input the sub-agent was tasked with. */
-    input: string;
-    /** Final assistant content from the child. */
+    status: SubagentStatus;
+    /** The input the sub-agent was tasked with. Not echoed to the model. */
+    input?: string;
+    /** Final assistant content from the child (partial unless `status` is `ok`). */
     content?: string;
     /** Parsed structured output, when the child had an `outputSchema`. */
     output?: any;
     /** Latest child summary, when summarization fired. */
     summary?: string;
-    /** Populated when the child failed or was refused by a guard. */
+    /** Set when the child produced no usable result (`error`, `blocked`, `needs_input`). */
     error?: string;
+    /** Why a result is partial or cancelled. */
+    note?: string;
+    /**
+     * The model calls this run made. Already merged into the parent's
+     * `state.usage` (each entry tagged `subagent`), so a parent budget sees them.
+     */
+    usage?: SubagentUsage;
     durationMs?: number;
 };
 /**
@@ -1563,6 +1616,13 @@ type StructuredSummary = {
      * the user explicitly revoked it (listed in `discarded_obsolete`).
      */
     user_directives?: string[];
+    /**
+     * Directive → the user's own words it came from, quoted verbatim from a user
+     * message. A directive is only kept when it can be traced to something the
+     * user said (see `summarization.groundDirectives`); the quote is what a later
+     * pass checks again, and what an operator reads to see where it came from.
+     */
+    user_directive_sources?: Record<string, string>;
     stable_facts: SummaryFactItem[];
     active_goals: string[];
     open_questions: string[];
@@ -1595,6 +1655,14 @@ type SmartAgentSummarizationConfig = {
     promptTemplate?: string;
     toolFreeCall?: boolean;
     integrityCheck?: boolean;
+    /**
+     * Keep a `user_directives` entry only when it traces back to a USER message
+     * (its quoted source is found there, or — for a summary that gave no quote —
+     * most of its words are). Default true. A directive the summarizer made up,
+     * or lifted from a tool output or from its own prompt, would otherwise be
+     * rendered to every later turn as "still in force — follow them".
+     */
+    groundDirectives?: boolean;
 };
 type SmartAgentBudgetConfig = {
     systemReserveTokens?: number;
@@ -2210,6 +2278,12 @@ type TraceSessionRuntime = {
     sequenceOffset?: number;
     /** 1-based part number; 1 for a session that starts with this invoke. */
     part?: number;
+    /**
+     * Set once the session has been handed to its sink. A closed session takes no
+     * more events: they would never be delivered (and, on a session continued by
+     * the next invoke, would collide with its sequence numbers).
+     */
+    closed?: boolean;
     fileBaseDir?: string;
     fileSessionDir?: string;
 };
@@ -2259,6 +2333,12 @@ type AgentState = {
             timestamp: string;
             turn: number;
             cachedInput?: number;
+            /** Present when a sub-agent made this call; it was merged in from the child's run. */
+            subagent?: {
+                name: string;
+                id: string;
+                mode: "registry" | "adhoc";
+            };
         }>;
         totals: Record<string, {
             input: number;
@@ -2376,6 +2456,17 @@ type SummarizationEvent = {
     archivedCount?: number;
     structuredSummary?: StructuredSummary;
     integrity?: SummaryIntegrityCheck;
+    /** Model that produced the summary. */
+    model?: string;
+    /** Directives the summarizer returned that were dropped, and why. */
+    droppedDirectives?: DroppedDirective[];
+};
+/** A `user_directives` entry the grounding check refused. */
+type DroppedDirective = {
+    directive: string;
+    reason: "not_found_in_user_messages" | "source_quote_not_found";
+    /** The quote the summarizer claimed, when it gave one. */
+    sourceQuote?: string;
 };
 type EvalFamily = "recall" | "state_continuity" | "summarization_fidelity" | "context_rollover" | "query_focused_summary";
 type EvalCase = {
@@ -2616,8 +2707,14 @@ type SubagentEvent = {
     parallel?: boolean;
     /** Task input (on `start`). */
     input?: string;
-    /** Final content (on `result`). */
+    /** Final content (on `result` / `error`; partial unless `status` is `ok`). */
     content?: string;
+    /** How the child ended (on `result` and `error`). */
+    status?: SubagentStatus;
+    /** Why the outcome is partial or cancelled. */
+    note?: string;
+    /** The child's model calls (on `result` and `error`); already merged into the parent's usage. */
+    usage?: SubagentUsage;
     error?: {
         message: string;
     };
@@ -2672,6 +2769,12 @@ type ProgressUpdate = {
 type StreamChunk = {
     text: string;
     isFinal?: boolean;
+    /**
+     * Set only on a sub-agent's chunk, and only when `subagentPolicy.streamChildren`
+     * is on. A chunk without it is the top-level agent's own text.
+     */
+    subagentName?: string;
+    subagentId?: string;
 };
 type InvokeConfig = RunnableConfig & {
     onEvent?: (event: SmartAgentEvent) => void;
@@ -2780,7 +2883,18 @@ type AgentInstance<TOutput = unknown> = {
 };
 type SmartAgentInstance<TOutput = unknown> = AgentInstance<TOutput>;
 
-type SmartToolFn = (args: any) => Promise<any> | any;
+/**
+ * Per-call context the tools node hands to a tool's `func` as its second
+ * argument. Anything that must be true of THIS call (rather than of the tool
+ * object, which sibling calls in the same turn share) belongs here.
+ */
+type ToolCallContext = {
+    /** The model's tool_call id for this exact call. */
+    toolCallId?: string;
+    cancellationToken?: any;
+    signal?: AbortSignal;
+};
+type SmartToolFn = (args: any, context?: ToolCallContext) => Promise<any> | any;
 type ToolCachePolicy = {
     /** Cache scope. "run" persists for the current invoke only. */
     scope?: "run";
@@ -2851,6 +2965,8 @@ declare function createResolverNode(): (state: SmartState) => Promise<SmartState
 
 declare function createToolLimitFinalizeNode(_opts: SmartAgentOptions): (state: SmartState) => Promise<Partial<SmartState>>;
 
+/** ctx key: the last pass's model call, read (and removed) by the smart driver for `postCompact`. */
+declare const LAST_SUMMARIZATION_CALL_KEY = "__lastSummarizationCall";
 /**
  * Creates the summarization node.
  *
@@ -3147,13 +3263,15 @@ declare function withinDepth(currentDepth: number, policy: SubagentPolicy): {
  * context policy. Extracted so both `asTool` delegation and the sub-agent tools
  * share ONE implementation.
  *
- *  - `full`    — entire parent transcript (minus its system prompt) + the input.
- *  - `scoped`  — last user turn + the task input.
- *  - `minimal` — only the task input (default).
+ *  - `minimal` — only the task input.
+ *  - `scoped`  — last user turn + the task input (default).
+ *  - `full`    — entire parent transcript (minus its system prompt and the
+ *                current turn's unresolved tool_calls) + the task input.
  *
- * The parent's system message is intentionally NOT carried over: the child agent
- * composes its own system prompt from its `SubagentDef.systemPrompt` (or role),
- * and leaking the parent's system message would suppress it.
+ * `scoped` and `full` mark the transcript as background and the input as the
+ * job. The parent's system message is intentionally NOT carried over: the child
+ * agent composes its own system prompt from its `SubagentDef.systemPrompt` (or
+ * role), and leaking the parent's system message would suppress it.
  */
 declare function seedChildMessages(policy: ChildContextPolicy, parentMessages: Message[], input: string): Message[];
 /**
@@ -3162,11 +3280,17 @@ declare function seedChildMessages(policy: ChildContextPolicy, parentMessages: M
  * or registry sub-agent can borrow a subset of the parent's capabilities.
  */
 declare function resolveSubagentTools(declared: SubagentDef["tools"] | string[] | undefined, parentTools: ToolInterface[]): Promise<ToolInterface[]>;
-/** The cheap catalog block the model always sees in its system prompt. */
+/**
+ * The cheap catalog block the model always sees in its system prompt: what it
+ * can delegate to, how to write a task, and how to read what comes back.
+ */
 declare function buildSubagentCatalogBlock(subagents: SubagentDef[], policy: SubagentPolicy, toolNames: {
     delegate: string;
     spawn: string;
     parallel: string;
+}, opts?: {
+    parentToolNames?: string[];
+    askUser?: boolean;
 }): string;
 
 /**
@@ -3177,6 +3301,10 @@ declare function buildSubagentCatalogBlock(subagents: SubagentDef[], policy: Sub
  * with createSmartAgent), and forward events/streaming/cancellation into each
  * child. Human-in-the-loop pauses inside a sequential child are surfaced to the
  * parent and resumed via `state.ctx.__subagentPending`.
+ *
+ * The `_stateRef` is shared by every call of a tool in a turn, so a call's own
+ * identity (its tool_call id) comes from the per-call context the tools node
+ * passes to `func`, never from the ref.
  */
 /** Config a child agent is built from. The factory lives in createSmartAgent. */
 type BuildChildConfig = {
@@ -3186,6 +3314,13 @@ type BuildChildConfig = {
     tools: ToolInterface[];
     outputSchema?: any;
     limits?: any;
+    /**
+     * Whether a question the child asks reaches a human: true under `delegate_to` /
+     * `spawn_subagent` (the pause is surfaced and resumed), false in a parallel
+     * fan-out (it ends the task as `needs_input`). Decides how the child is told
+     * about asking.
+     */
+    interactive: boolean;
 };
 type SubagentToolDeps = {
     registryRef: SubagentRegistryRef;
@@ -3199,7 +3334,16 @@ type SubagentToolDeps = {
         spawn?: string;
         parallel?: string;
     };
+    /** Names of the parent's tools an ad-hoc child may borrow, listed to the model. */
+    parentToolNames?: string[];
+    /** True when the parent has `humanInTheLoop.askUser`, which its children inherit. */
+    canAskUser?: boolean;
 };
+/**
+ * What the model is shown of a result: no `input` (it wrote it), no `usage` or
+ * `durationMs` (bookkeeping for the host, tokens for the model to spend).
+ */
+declare function toModelResult(result: SubagentResult): Omit<SubagentResult, "input" | "usage" | "durationMs">;
 declare function createDelegateTool(deps: SubagentToolDeps): ToolInterface;
 declare function createSpawnTool(deps: SubagentToolDeps): ToolInterface;
 declare function createParallelTool(deps: SubagentToolDeps): ToolInterface;
@@ -4329,6 +4473,18 @@ type SessionMetrics = {
     totalTokens: number;
     /** Present only when a `costEstimator` was configured. */
     estimatedCostUsd?: number;
+    /**
+     * What sub-agents spent during this run, kept apart from the figures above:
+     * each child opens its own session and reports its own record, so folding
+     * them in would count every child token twice in a pipeline that sums runs.
+     * Present only when the run delegated.
+     */
+    subagentCalls?: number;
+    subagentInputTokens?: number;
+    subagentOutputTokens?: number;
+    subagentTotalTokens?: number;
+    /** Present only with a `costEstimator` and sub-agent calls. */
+    subagentEstimatedCostUsd?: number;
     /** Executions per tool name. Opt-in — a wide tool menu makes this unbounded. */
     toolBreakdown?: Record<string, number>;
 };
@@ -5413,6 +5569,12 @@ declare function buildToolDefinitionsSection(toolDefinitions: Array<{
  * Exported for provider/node code that assembles sections itself.
  */
 declare function buildResponseFormatSection(responseFormat: Record<string, any> | undefined, strategy?: "native" | "tool_based"): TraceResponseFormatSection | undefined;
+/**
+ * The message sections `recordTraceEvent` builds from a `messageList`, for a
+ * caller that needs them next to sections of its own (an event takes either
+ * `sections` or `messageList`, not both).
+ */
+declare function traceSectionsFromMessages(messageList?: any[]): TraceDataSection[];
 /**
  * Reads a `ctx.__traceContinuation` value back, or undefined when it is not
  * one. It arrives from caller-persisted state, so every field is checked.
@@ -5425,6 +5587,83 @@ declare function traceContinuationOf(session: TraceSessionRuntime): TraceContinu
  * This sends the session start to the remote endpoint immediately.
  */
 declare function startStreamingSession(session: TraceSessionRuntime | undefined, agentRuntime?: AgentRuntimeConfig): Promise<void>;
+declare function recordTraceEvent(session: TraceSessionRuntime | undefined, event: {
+    type: string;
+    label?: string;
+    timestamp?: string;
+    actor?: TraceEventRecord["actor"];
+    status?: TraceEventRecord["status"];
+    /** Explicit parent span ID. Falls back to session.currentIterationSpanId when omitted. */
+    parentSpanId?: string;
+    durationMs?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedInputTokens?: number;
+    /** Subset of `outputTokens` spent on reasoning (see TraceEventRecord). */
+    reasoningTokens?: number;
+    /** Why the model stopped — `length` explains most truncated JSON. */
+    finishReason?: string;
+    requestBytes?: number;
+    responseBytes?: number;
+    model?: string;
+    provider?: string;
+    toolDetails?: TraceEventRecord["toolDetails"];
+    toolExecutionId?: string;
+    retryOf?: string;
+    error?: {
+        message: string;
+        stack?: string;
+    } | null;
+    messageList?: any[];
+    /** Pre-built sections to use instead of auto-converting messageList */
+    sections?: TraceDataSection[];
+    /**
+     * Tool MENU bound to this model call (`ai_call` events). Appended as a
+     * `tool_definitions` section AFTER messageList/sections resolution, so it
+     * composes with the auto-converted message sections instead of replacing
+     * them. Size-capped; suppressed when logData is off.
+     */
+    toolDefinitions?: Array<{
+        name: string;
+        description?: string;
+        parameters?: Record<string, any>;
+    }>;
+    /**
+     * Structured-output CONTRACT bound to this model call (`ai_call` events),
+     * appended as a `response_format` section next to the tool menu. Accepts
+     * the `{ response_format: … }` invoke-options envelope or a bare
+     * response_format object. Size-capped; suppressed when logData is off.
+     */
+    responseFormat?: Record<string, any>;
+    /** Which structured-output strategy produced `responseFormat`. */
+    responseFormatStrategy?: "native" | "tool_based";
+    debug?: Record<string, any>;
+}): TraceEventRecord | undefined;
+/** An event held for the next trace session: the same input `recordTraceEvent` takes. */
+type DeferredTraceEvent = Parameters<typeof recordTraceEvent>[1];
+/**
+ * True when `session` still accepts events. The smart agent runs a turn as
+ * several invokes ("legs") and does its own work — context summarization — in
+ * between them; at that point the previous leg has already handed its session
+ * to the sink, and the next leg has not opened one yet.
+ */
+declare function isTraceSessionOpen(session: TraceSessionRuntime | undefined): session is TraceSessionRuntime;
+/**
+ * Records `event` into the open session on `ctx`, or — when there is none —
+ * returns a copy of `ctx` holding it for the next invoke to record. Returns
+ * undefined when nothing on ctx changed (recorded, or tracing is off).
+ */
+declare function recordOrDeferTraceEvent(ctx: Record<string, any> | undefined, event: DeferredTraceEvent, options: {
+    tracingEnabled: boolean;
+}): Record<string, any> | undefined;
+/**
+ * Records events another invoke held for this one (see `recordOrDeferTraceEvent`),
+ * in the order they happened. They keep their own timestamps; they get this
+ * session's next sequence numbers, which is where they belong — after what the
+ * previous leg recorded, before anything this one does.
+ */
+declare function replayDeferredTraceEvents(session: TraceSessionRuntime | undefined, deferred: unknown): void;
 
 /** True when the model's rule uses `thinking:{type:"adaptive"}` + `output_config.effort` (Claude 4.6+ / 5.x). */
 declare function supportsAdaptiveThinking(model: unknown): boolean;
@@ -5745,4 +5984,4 @@ declare class ModelRequestError extends ProviderError {
     constructor(init: ModelRequestErrorInit);
 }
 
-export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, AnthropicProviderConfig, type ApprovalTransport, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, 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 ConversationPluginConfig, type ConversationStore, type CostEstimator, 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, EmbeddingRequest, EmbeddingResponse, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailJudgeEngine, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JevClientLike, type JevEngineOptions, type JevNoulAnswer, JevProvider, JevProviderConfig, type JevQuestion, type JevSystemOneRequest, type JevSystemOneResult, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind$1 as MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MessageUsage, type MetadataEvent, type ModelCapabilities, ModelRequestError, type ModelRequestErrorCode, type ModelRequestErrorInit, ModelRuleLearnedEvent, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, ProviderConfig, ProviderError, ToolDefinition as ProviderToolDefinition, ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, RulePatch, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, 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 StrictRestorers, type StrictTransform, 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 SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TokenCounter, TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceContinuation, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessagePart, 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 TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentPartToText, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, describeContentPart, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasMediaPart, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaKindOf, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, readTraceContinuation, redactText, regexGuardrail, regexRule, replaceTextContent, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, supportsAdaptiveThinking, textFromContent, toMessageUsage, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceContinuationOf, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };
+export { type AIMessage, ASK_USER_TOOL_NAME, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentPlugin, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, AnthropicProviderConfig, type ApprovalTransport, type AuditEntry, type AuditLogConfig, type AzureContentSafetyConfig, AzureProvider, AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, type BedrockGuardrailConfig, BedrockProvider, BedrockProviderConfig, type BudgetGuardConfig, type BuildChildConfig, type BuiltInRuntimeProfile, CCRStore, CONSOLE_HOOK_MAP, CONTEXT_PILOT_JSON_MARKER_KEY, CONTROL_PLANE_TOOL_NAMES, type CancellationTokenLike, type CancelledEvent, type CapabilityStatus, ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse, type CheckpointPluginConfig, type CheckpointStore, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type CognipeerGuardrailConfig, type CompressToolOutputParams, type ContextBuilder, 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 ConversationPluginConfig, type ConversationStore, type CostEstimator, 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 DeferredTraceEvent, type DelegationEventStamp, type DelegationMode, type DroppedDirective, EmbeddingRequest, EmbeddingResponse, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type GateResult, type GuardrailCallContext, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailJudgeEngine, type GuardrailOutcome, GuardrailPhase, type GuardrailPhaseName, type GuardrailPluginOptions, type GuardrailRequest, type GuardrailRule, type GuardrailRuleResult, type GuardrailTransport, type GuardrailVerdict, type GuardrailViolation, HOOK_CONTRACT_VERSION, HOOK_NAMES, type HandoffDescriptor, type HandoffEvent, type HookContext, type HookDecision, type HookHandler, type HookMap, type HookName, type HookRegistrations, HookTimeoutError, type HttpGuardrailOptions, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, InMemoryMemoryStore, type InjectionScan, type InvokeConfig, type JevClientLike, type JevEngineOptions, type JevNoulAnswer, JevProvider, JevProviderConfig, type JevQuestion, type JevSystemOneRequest, type JevSystemOneResult, type JsonGuardrailOptions, type JsonSchemaRuleOptions, LAST_SUMMARIZATION_CALL_KEY, type LangfuseBuildContext, type LangfuseEvent, type LangfuseEventKind, type LangfuseTracingConfig, type LanguageGuardConfig, type LoadSkillsOptions, type MaybePromise, type McpConfig, type McpConnection, type MediaAttachment, type MediaKind$1 as MediaKind, type MediaPolicyConfig, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MessageUsage, type MetadataEvent, type ModelCapabilities, ModelRequestError, type ModelRequestErrorCode, type ModelRequestErrorInit, ModelRuleLearnedEvent, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, OpenAICompatibleProviderConfig, type OpenAIModerationConfig, OpenAIProvider, OpenAIProviderConfig, type OtelTracingConfig, type OutputGuardConfig, PREOPEN_TOOL_CALL_PREFIX, type PendingToolApproval, type PendingUserQuestion, type PiiDetector, type PiiEntity, type PiiRedactionConfig, type PlanEvent, type PlanStepRecord, type PlanningMode, type PluginContributions, type PluginEvent, type PluginFailureMode, type PluginHost, type PluginHostOptions, type PluginLogger, type PluginProvides, type PluginRunHost, type PluginSetupContext, type PortkeyGatewayConfig, type PortkeyGuardrailConfig, type PreopenSkillsResult, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type PromptInjectionFamily, type PromptInjectionGuardConfig, type PromptSource, ProviderConfig, ProviderError, ToolDefinition as ProviderToolDefinition, ProviderType, type RateLimitConfig, type ReasoningConfig, type ReasoningLevel, type RedactionResult, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailConfig, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedContextPilotConfig, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type ResponseCacheConfig, type RestoreSnapshotOptions, RulePatch, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SdkCapabilities, type SerializableSmartState, type SessionMetrics, type SessionMetricsConfig, type Skill, type SkillDisclosure, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillSource, type SkillToolDeps, type SkillToolHeader, type SlotName, 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 StrictRestorers, type StrictTransform, 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 SubagentStatus, type SubagentToolDeps, type SubagentToolNames, type SubagentUsage, type SummarizationEvent, type SummarizationMode, type SummarizerInput, type SummarizerResult, type SummarizerStrategy, type SummaryFactItem, type SummaryIntegrityCheck, TOOL_INPUT_DIGEST_KEY, type TokenCounter, TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallContext, type ToolCallEvent, type ToolInputDigestOptions, type ToolInputDigestResult, type ToolInputRetentionPolicy, type ToolInterface, type ToolPolicyConfig, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetentionDeclarations, type ToolRetentionSpec, type ToolRetryPolicy, type ToolRule, type TraceContinuation, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessagePart, 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 TraceToolDefinition, type TraceToolDefinitionsSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, VertexProviderConfig, type VolatileContentFinding, type VolatileContentPattern, type WebhookApprovalConfig, agentVerdictRule, appendBoundTools, auditLog, azureContentSafety, bedrockGuardrail, budgetGuard, buildHandoffTools, buildResponseFormatSection, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, buildToolDefinitionsSection, canOpenSkill, canSpawn, captureSnapshot, checkpointing, codePresenceRule, coerceToolArgs, cognipeerGuardrail, cognipeerSink, collectAttachments, collectToolRetentionDeclarations, composeToolSets, compressDiffOutput, compressJsonOutput, compressLogOutput, compressSearchOutput, compressTextOutput, compressToolOutput, contentPartToText, contentToString, conversationHistory, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextPilotRuntime, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createGuardrailPlugin, createJsonGuardrail, createManageTodoListAliasTool, createManageTodoTool, createOpenSkillTool, createParallelTool, createPluginHost, createProvider, createRegexGuardrail, createResolverNode, createSearchSkillsTool, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customGuardrail, customSink, dedupeToolsByName, defaultTokenCounter, defineHook, definePlugin, describeContentPart, detectLanguage, detectTextFormat, detectVolatileContent, digestToolInputArguments, digestToolInputValue, evaluateGuardrails, extractLatestUserQuery, extractMessageText, fileCheckpointStore, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasMediaPart, hasToolResponseRecoveryReference, httpGuardrail, httpSink, inMemoryCheckpointStore, inMemoryConversationStore, isHookImplemented, isOpenAIHostedEndpoint, isSmartModel, isTraceSessionOpen, isValidIban, isValidLuhn, isValidTckn, jsonSchemaRule, defaultBuildPayload as langfuseDefaultPayload, langfuseTracing, languageGuard, loadSkillsFromDisk, mapConsoleHookVerdict, mapTextParts, mcp, mediaKindOf, mediaPolicy, normalizeSmartAgentOptions, normalizeVerdicts, openAIModeration, otelTracing, otlpSink, outputGuard, parseApprovalDecision, parseSkillFrontmatter, pathSandbox, piiRedaction, pluginCapabilities, portkeyGateway, portkeyGuardrail, preopenSkills, preopenToolCallId, prepareStrictToolMenu, promptInjectionGuard, rateLimit, readMemoryFacts, readTraceContinuation, recordOrDeferTraceEvent, redactText, regexGuardrail, regexRule, replaceTextContent, replayDeferredTraceEvents, resolveAvailableSkills, resolveAvailableSubagents, resolveInputRetention, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveSummarizationRetention, resolveToolApprovalState, resolveUserQuestionState, responseCache, restoreSnapshot, restoreToolCalls, runSmartAgentEvalHarness, scoreItemsByRelevance, searchSkills, seedChildMessages, selectTopIndicesInOrder, sessionMetrics, setTokenCounter, startStreamingSession, summarizeObject, supportsAdaptiveThinking, textFromContent, toMessageUsage, toModelResult, toStrictCompatible, toStrictToolSchema, tokenize, toolPolicy, traceContinuationOf, traceSectionsFromMessages, traceSessionToOtlp, validateReasoningConfig, validateToolArgs, webhookApproval, withTools, withinDepth, writeSummaryFactsToMemory };