@cognipeer/agent-sdk 0.7.2 → 0.8.0

package/dist/index.d.cts

@@ -107,6 +107,136 @@ declare function withTools(model: SmartModel, tools: any[], options?: {
 }): BaseChatModel;
 declare function fromLangchainModel(lcModel: any): BaseChatModel;
 
+/**
+ * Sub-agent primitive — dynamic problem-solving by delegating self-contained
+ * subtasks to focused child agents.
+ *
+ * Two complementary disclosure modes (hybrid by default):
+ *  - **Registry** — predefined, named sub-agents (`delegate_to(name, input)`).
+ *  - **Ad-hoc**   — the orchestrator writes a role + prompt + tool subset at
+ *    runtime (`spawn_subagent({ role, prompt, input, tools })`).
+ *  - **Parallel** — fan out independent subtasks concurrently
+ *    (`spawn_subagents_parallel({ tasks })`).
+ *
+ * The primitive reuses the existing delegation guards (depth / child-call
+ * budget / context policy) and forwards events, streaming, cancellation and
+ * tracing from the parent run into each child. Model-agnostic: a child uses its
+ * own `model` override when given, otherwise the parent's model.
+ */
+/** A predefined sub-agent the orchestrator can invoke by name. */
+type SubagentDef = {
+    /** Stable id used by `delegate_to`. */
+    name: string;
+    /** Human-friendly title (defaults to `name`). */
+    title?: string;
+    /** One-line "what + when to use" shown in the `<available_subagents>` catalog. */
+    header: string;
+    /**
+     * Role / system prompt for the child agent. This is fully under your control
+     * — it is the per-sub-agent prompt-override surface.
+     */
+    systemPrompt?: string;
+    /**
+     * Tool surface for the child:
+     *  - `ToolInterface[]` — explicit tools.
+     *  - `string[]`        — names resolved against the PARENT's live tool set.
+     *  - function          — built lazily at spawn time.
+     * When omitted the child runs tool-free (pure reasoning).
+     */
+    tools?: ToolInterface[] | string[] | (() => ToolInterface[] | Promise<ToolInterface[]>);
+    /** Optional model override. Defaults to the parent agent's model (model-agnostic). */
+    model?: any;
+    /** Optional JSON output contract for the child. */
+    outputSchema?: ZodSchema<any>;
+    /** Optional per-child limits override. */
+    limits?: AgentLimits;
+    /** Override the parent policy's context-seeding behaviour for this sub-agent. */
+    childContextPolicy?: ChildContextPolicy;
+    /** Gate: hide this sub-agent from the catalog when it returns false. */
+    isAvailable?: () => boolean | Promise<boolean>;
+    /** Free-form metadata surfaced on `subagent` events. */
+    metadata?: Record<string, any>;
+};
+type SubagentMode = "off" | "registry_only" | "registry_and_adhoc";
+type SubagentPolicy = {
+    /** `registry_and_adhoc` (default) enables both named + ad-hoc spawning. */
+    mode: SubagentMode;
+    /** Max nesting depth. Shares the delegation depth counter. */
+    maxDepth: number;
+    /** Total spawn budget per run (across delegate_to + spawn + parallel). */
+    maxChildCalls: number;
+    /** Fan-out width for `spawn_subagents_parallel`. */
+    maxParallel: number;
+    /** Default context seeding for children. Overridable per-`SubagentDef`. */
+    childContextPolicy: ChildContextPolicy;
+    /** Whether ad-hoc spawns may reference the parent's tools by name. */
+    allowAdhocTools: boolean;
+};
+declare const DEFAULT_SUBAGENT_POLICY: SubagentPolicy;
+/** Result of a single sub-agent run (returned to the model as the tool result). */
+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. */
+    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. */
+    error?: string;
+    durationMs?: number;
+};
+/**
+ * Mutable per-invoke registry. Records spawn budget usage and completed
+ * results. Mirrors the SkillRegistryRef pattern. The durable child-pause state
+ * (for HITL resume) lives in `state.ctx.__subagentPending`, NOT here, so it
+ * survives the parent invoke boundary.
+ */
+type SubagentRegistryRef = {
+    /** Cumulative spawns this run (delegate + adhoc + each parallel child). */
+    spawnedCount: number;
+    /** Completed results, in completion order. */
+    results: SubagentResult[];
+};
+declare function createSubagentRegistryRef(): SubagentRegistryRef;
+/**
+ * Durable per-tool-call pause record, stored in `state.ctx.__subagentPending`
+ * so a child that paused for human input (approval / ask-user) can be resumed
+ * after the host answers at the parent level. Only data — no functions — so it
+ * survives snapshot serialization for the in-memory resume path.
+ */
+type SubagentPendingRecord = {
+    /** Parent tool_call id that owns this paused child. */
+    parentToolCallId: string;
+    /** Sub-agent name / role. */
+    name: string;
+    mode: "registry" | "adhoc";
+    /** Ad-hoc spec (role/prompt/tools/input) to rebuild the child agent. */
+    adhoc?: {
+        role: string;
+        prompt?: string;
+        toolNames?: string[];
+        outputContract?: string;
+    };
+    /** The task input the child was running. */
+    input: string;
+    /** Serializable child SmartState (agent omitted) to restore + resume. */
+    childState: any;
+    /** Maps the child's pending approval/question id -> parent-surfaced id. */
+    pendingKind: "approval" | "user_question";
+    pendingId: string;
+};
+type SubagentToolNames = {
+    delegate: string;
+    spawn: string;
+    parallel: string;
+};
+declare const DEFAULT_SUBAGENT_TOOL_NAMES: SubagentToolNames;
+
 /**
  * Skill primitive — progressive capability disclosure for the smart agent.
  *
@@ -651,6 +781,48 @@ type SmartAgentOptions = {
     skills?: Skill[];
     /** Caps/tiering for skill disclosure. Defaults to DEFAULT_SKILL_POLICY. */
     skillPolicy?: SkillPolicy;
+    /**
+     * Sub-agents for dynamic problem decomposition. When provided (or when
+     * `subagentPolicy.mode` enables ad-hoc spawning), the agent exposes
+     * `delegate_to` / `spawn_subagent` / `spawn_subagents_parallel` tools and a
+     * `<available_subagents>` catalog in its system prompt. Children inherit the
+     * parent model (unless a `SubagentDef.model` override is given), and the
+     * parent's event/streaming/cancellation/trace wiring.
+     */
+    subagents?: SubagentDef[];
+    /** Caps/modes for sub-agent spawning. Defaults to DEFAULT_SUBAGENT_POLICY. */
+    subagentPolicy?: SubagentPolicy;
+    /**
+     * Hooks to intercept/override the SDK's otherwise-static prompt surfaces:
+     * the composed system prompt, built-in tool descriptions, and the sub-agent
+     * catalog block. See {@link PromptHooks}.
+     */
+    promptHooks?: PromptHooks;
+};
+/**
+ * Override points for the SDK's built-in (otherwise static) prompt surfaces.
+ * Every hook is optional and additive — when omitted the defaults are used.
+ */
+type PromptHooks = {
+    /**
+     * Transform the fully-composed system prompt right before it is sent. Receives
+     * the default prompt and returns the prompt to use.
+     */
+    transformSystemPrompt?: (prompt: string, ctx: {
+        agentName: string;
+    }) => string;
+    /**
+     * Override built-in tool descriptions by tool name (e.g. `delegate_to`,
+     * `spawn_subagent`, `spawn_subagents_parallel`, `open_skill`,
+     * `ask_user_question`). A string replaces the description; a function receives
+     * the default and returns the replacement.
+     */
+    toolDescriptions?: Record<string, string | ((defaultDescription: string) => string)>;
+    /**
+     * Override the `<available_subagents>` catalog block. Receives the default
+     * block and the active sub-agent definitions.
+     */
+    subagentCatalog?: (defaultBlock: string, subagents: SubagentDef[]) => string;
 };
 type AgentRuntimeConfig = {
     name?: string;
@@ -1285,7 +1457,43 @@ type GuardrailEvent = {
     reason?: string;
     details?: Record<string, any>;
 };
-type SmartAgentEvent = ToolCallEvent | ToolApprovalEvent | UserQuestionEvent | PlanEvent | SummarizationEvent | FinalAnswerEvent | MetadataEvent | HandoffEvent | GuardrailEvent | ProgressEvent | StreamEvent | CancelledEvent | ReflectionEvent;
+type SubagentEvent = {
+    type: "subagent";
+    /** Lifecycle phase of a delegated sub-agent run. */
+    phase: "start" | "result" | "error" | "paused";
+    /** Sub-agent name (registry) or role (ad-hoc). */
+    name: string;
+    /** Unique per-spawn id. */
+    id: string;
+    mode: "registry" | "adhoc";
+    /** Parent tool_call id that owns this sub-agent. */
+    parentToolCallId?: string;
+    /** True when spawned inside `spawn_subagents_parallel`. */
+    parallel?: boolean;
+    /** Task input (on `start`). */
+    input?: string;
+    /** Final content (on `result`). */
+    content?: string;
+    error?: {
+        message: string;
+    };
+    durationMs?: number;
+};
+/**
+ * Origin-stamp fields the runtime attaches to any event that was forwarded from
+ * a delegated child. Sub-agent children stamp `subagentId` / `subagentName`;
+ * `asTool` delegated children stamp `delegatedTo`. All optional and absent on a
+ * top-level agent's own events.
+ */
+type DelegationEventStamp = {
+    /** Per-spawn id of the sub-agent that produced this forwarded event. */
+    subagentId?: string;
+    /** Sub-agent name / role that produced this forwarded event. */
+    subagentName?: string;
+    /** Name of the `asTool` child agent this forwarded event came from. */
+    delegatedTo?: string;
+};
+type SmartAgentEvent = (ToolCallEvent | ToolApprovalEvent | UserQuestionEvent | PlanEvent | SummarizationEvent | FinalAnswerEvent | MetadataEvent | HandoffEvent | GuardrailEvent | ProgressEvent | StreamEvent | CancelledEvent | SubagentEvent | ReflectionEvent) & DelegationEventStamp;
 type ReflectionEvent = {
     type: "reflection";
     id: string;
@@ -1575,6 +1783,148 @@ declare function createBindSkillToolsTool(deps: SkillToolDeps): ToolInterface;
 /** Both skill tools for an invoke, sharing one registry ref. */
 declare function createSkillTools(deps: SkillToolDeps): ToolInterface[];
 
+/**
+ * Native SKILL.md loader — Anthropic-style filesystem skills for the smart agent.
+ *
+ * Discovers `<root>/<name>/SKILL.md` documents, parses their frontmatter, and
+ * adapts each into a {@link Skill} with progressive disclosure:
+ *   - level 1: `header` (frontmatter description) — always in the catalog;
+ *   - level 2: `prompt` (the markdown body) — returned on `open_skill`;
+ *   - level 3: bundled `scripts/` — exposed as tools that execute out-of-context
+ *     via an injected {@link SkillExecutionContext} (e.g. a sandbox), so script
+ *     source never enters the model context.
+ *
+ * The filesystem is injected (`SkillFs`) so skills can live on local disk or on
+ * a remote sandbox filesystem. This module is additive: it produces standard
+ * `Skill` objects consumable by `createSmartAgent({ skills })`.
+ */
+/** Minimal filesystem the loader needs; satisfiable by node fs or a sandbox fs. */
+interface SkillFs {
+    /** Entry names directly under `dir`. Reject if `dir` does not exist. */
+    listDir(dir: string): Promise<string[]>;
+    /** Read a UTF-8 file. Reject if the file does not exist. */
+    readFile(path: string): Promise<string>;
+}
+/** Executes a skill's bundled script out of context and returns its output. */
+interface SkillExecutionContext {
+    /**
+     * Run a bundled script (path relative to the skill directory) with the given
+     * arguments. Implementations typically shell out inside a sandbox and return
+     * stdout / a parsed result.
+     */
+    executeScript(scriptPath: string, args: Record<string, unknown>): Promise<unknown>;
+}
+interface LoadSkillsOptions {
+    fs: SkillFs;
+    /** Directories to scan for `<name>/SKILL.md`. */
+    roots: string[];
+    /** When provided, bundled scripts become executable tools. */
+    execution?: SkillExecutionContext;
+    /** Default model-tier gate applied to discovered skills. */
+    minModelTier?: "small" | "large";
+}
+interface SkillFrontmatter {
+    metadata: Record<string, string | string[]>;
+    body: string;
+}
+/** Parse SKILL.md frontmatter + body. No YAML dependency. */
+declare function parseSkillFrontmatter(md: string): SkillFrontmatter;
+/**
+ * Discover and load all SKILL.md skills under the configured roots. Returns
+ * standard `Skill` objects ready to pass to `createSmartAgent({ skills })`.
+ */
+declare function loadSkillsFromDisk(opts: LoadSkillsOptions): Promise<Skill[]>;
+
+/**
+ * Pure registry helpers for the sub-agent primitive. No I/O, no agent loop —
+ * the deterministic core, fully unit-testable on its own.
+ */
+/** Look up a registry sub-agent by name. */
+declare function findSubagent(subagents: SubagentDef[], name: string): SubagentDef | undefined;
+/** Filter the catalog to sub-agents usable now (availability gate). */
+declare function resolveAvailableSubagents(subagents: SubagentDef[]): Promise<SubagentDef[]>;
+/**
+ * Spawn guard: may the run spawn `count` more children? Enforces the per-run
+ * child-call budget. Depth is checked separately against the live ctx because
+ * it depends on the parent's `__delegationDepth`.
+ */
+declare function canSpawn(ref: SubagentRegistryRef, policy: SubagentPolicy, count?: number): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Depth guard, evaluated against the current delegation depth from ctx. */
+declare function withinDepth(currentDepth: number, policy: SubagentPolicy): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Seed the child's initial messages from the parent transcript according to the
+ * 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).
+ *
+ * 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[];
+/**
+ * Resolve a sub-agent's declared tool surface to concrete tools. `string[]`
+ * entries are matched (by name) against the parent's live tool set so an ad-hoc
+ * 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. */
+declare function buildSubagentCatalogBlock(subagents: SubagentDef[], policy: SubagentPolicy, toolNames: {
+    delegate: string;
+    spawn: string;
+    parallel: string;
+}): string;
+
+/**
+ * Per-invoke sub-agent tools (`delegate_to`, `spawn_subagent`,
+ * `spawn_subagents_parallel`). They read the parent runtime/context from the
+ * tool `_stateRef` (injected by the tools node), build child agents via the
+ * injected `buildChild` factory (dependency injection avoids a circular import
+ * 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`.
+ */
+/** Config a child agent is built from. The factory lives in createSmartAgent. */
+type BuildChildConfig = {
+    name: string;
+    model: any;
+    systemPrompt?: string;
+    tools: ToolInterface[];
+    outputSchema?: any;
+    limits?: any;
+};
+type SubagentToolDeps = {
+    registryRef: SubagentRegistryRef;
+    subagents: SubagentDef[];
+    policy: SubagentPolicy;
+    /** DI: build a child SmartAgent instance (createSmartAgent closure). */
+    buildChild: (cfg: BuildChildConfig) => SmartAgentInstance;
+    /** Optional prompt-override descriptions for the three tools. */
+    descriptions?: {
+        delegate?: string;
+        spawn?: string;
+        parallel?: string;
+    };
+};
+declare function createDelegateTool(deps: SubagentToolDeps): ToolInterface;
+declare function createSpawnTool(deps: SubagentToolDeps): ToolInterface;
+declare function createParallelTool(deps: SubagentToolDeps): ToolInterface;
+/** Build the sub-agent tool set for an invoke, all sharing one registry ref. */
+declare function createSubagentTools(deps: SubagentToolDeps): ToolInterface[];
+
 type EvalHarnessParams = {
     profiles: EvalProfileTarget[];
     cases: EvalCase[];
@@ -2354,4 +2704,4 @@ declare function fromNativeProvider(provider: BaseProvider, options?: NativeMode
  */
 declare function createProvider(config: ProviderConfig): BaseProvider;
 
-export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, BedrockProvider, type BedrockProviderConfig, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type FinishReason, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailRule, type HandoffDescriptor, type HandoffEvent, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, InMemoryMemoryStore, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, OpenAIProvider, type OpenAIProviderConfig, type PendingToolApproval, type PendingUserQuestion, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type ReasoningConfig, type ReasoningLevel, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SerializableSmartState, type Skill, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillToolDeps, type SkillToolHeader, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetryPolicy, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, agentVerdictRule, appendBoundTools, buildSkillHeaderBlock, buildSystemPrompt, canOpenSkill, captureSnapshot, codePresenceRule, cognipeerSink, composeToolSets, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createOpenSkillTool, createProvider, createRegexGuardrail, createResolverNode, createSkillRegistryRef, createSkillTools, createSmartAgent, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, normalizeSmartAgentOptions, otlpSink, readMemoryFacts, regexRule, resolveAvailableSkills, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, setTokenCounter, startStreamingSession, traceSessionToOtlp, validateReasoningConfig, withTools, writeSummaryFactsToMemory };
+export { type AIMessage, type AgentInstance, type AgentInvokeResult, type AgentLimits, type AgentOptions, type AgentRuleOptions, type AgentRuntimeConfig, type AgentSnapshot, type AgentSnapshotMetadata, type AgentState, AnthropicProvider, type AnthropicProviderConfig, AzureProvider, type AzureProviderConfig, type BaseChatMessage, type BaseChatMessagePart, type BaseChatModel, type BaseMessage, BaseProvider, BedrockProvider, type BedrockProviderConfig, type BuildChildConfig, type BuiltInRuntimeProfile, type CancellationTokenLike, type CancelledEvent, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChildContextPolicy, type CodeDetectionRuleOptions, type CodeGuardrailOptions, type ContextPolicy, type ContextToolsStateRef, type ConversationGuardrail, type CustomRuleCallback, type CustomRuleOptions, DEFAULT_PROFILE_CONFIGS, DEFAULT_SKILL_POLICY, DEFAULT_SUBAGENT_POLICY, DEFAULT_SUBAGENT_TOOL_NAMES, type DelegationEventStamp, type DelegationMode, type EvalCase, type EvalCaseResult, type EvalFamily, type EvalHarnessMetrics, type EvalHarnessParams, type EvalHarnessResult, type EvalProfileDescriptor, type EvalProfileTarget, type FinalAnswerEvent, type FinishReason, type GuardrailContext, type GuardrailDisposition, type GuardrailEvent, type GuardrailIncident, type GuardrailOutcome, GuardrailPhase, type GuardrailRule, type HandoffDescriptor, type HandoffEvent, type HumanInTheLoopAskUserConfig, type HumanInTheLoopOptions, type HumanInTheLoopRuntimeConfig, InMemoryMemoryStore, type InvokeConfig, type JsonGuardrailOptions, type JsonSchemaRuleOptions, type LoadSkillsOptions, type MemoryFact, type MemoryProviderKind, type MemoryReadPolicy, type MemoryScope, type MemoryStore, type MemoryWritePolicy, type Message, type MetadataEvent, type ModelCapabilities, NativeJsonSchemaStrategy, type NativeModelOptions, type NativeReasoningConfig, OpenAICompatibleProvider, type OpenAICompatibleProviderConfig, OpenAIProvider, type OpenAIProviderConfig, type PendingToolApproval, type PendingUserQuestion, type PlanEvent, type PlanStepRecord, type PlanningMode, type ProfileConfig, type ProgressEvent, type ProgressUpdate, type PromptHooks, type ProviderConfig, ProviderError, type ToolCall as ProviderToolCall, type ToolDefinition as ProviderToolDefinition, type ProviderType, type ReasoningConfig, type ReasoningLevel, type ReflectionCadence, type ReflectionConfig, type ReflectionEvent, type ReflectionHookContext, type ReflectionRecord, type RegexGuardrailOptions, type RegexRuleOptions, type ReplanPolicy, type ResolvedSmartAgentConfig, type ResolvedTraceConfig, type ResolvedTraceSink, type RestoreSnapshotOptions, type RuntimeProfile, SMALL_TIER_SKILL_POLICY, type SerializableSmartState, type Skill, type SkillExecutionContext, type SkillFrontmatter, type SkillFs, type SkillModelTier, type SkillPolicy, type SkillRegistryRef, type SkillToolDeps, type SkillToolHeader, type SmartAgentBudgetConfig, type SmartAgentContextConfig, type SmartAgentCustomProfileConfig, type SmartAgentDelegationConfig, type SmartAgentEvent, type SmartAgentInstance, type SmartAgentLimits, type SmartAgentMemoryConfig, type SmartAgentOptions, type SmartAgentPlanningConfig, type SmartAgentSummarizationConfig, type SmartAgentToolResponseConfig, type SmartAgentTracingConfig, type SmartModel, type SmartState, type SmartToolFn, type SnapshotOptions, type SnapshotRuntimeHint, type StreamChunk, type StreamEvent, type StructuredOutputError, type StructuredOutputFieldError, StructuredOutputManager, type StructuredOutputManagerConfig, type StructuredOutputResult, type StructuredOutputStrategy, type StructuredSummary, type SubagentDef, type SubagentEvent, type SubagentMode, type SubagentPendingRecord, type SubagentPolicy, type SubagentRegistryRef, type SubagentResult, type SubagentToolDeps, type SubagentToolNames, type SummarizationEvent, type SummarizationMode, type SummaryFactItem, type SummaryIntegrityCheck, type TokenCounter, type TokenUsage, type ToolApprovalEvent, type ToolApprovalResolution, type ToolApprovalStatus, ToolBasedStrategy, type ToolCachePolicy, type ToolCallEvent, type ToolInterface, type ToolResponseClassification, type ToolResponseRetentionPolicy, type ToolRetryPolicy, type TraceDataSection, type TraceErrorRecord, type TraceEventRecord, type TraceMessageSection, type TraceMetadataSection, type TraceSessionConfigSnapshot, type TraceSessionFile, type TraceSessionStatus, type TraceSessionSummary, type TraceSinkCognipeerConfig, type TraceSinkConfig, type TraceSinkCustomConfig, type TraceSinkFileConfig, type TraceSinkHttpConfig, type TraceSinkOtlpConfig, type TraceSinkSnapshot, type TraceSummarySection, type TraceToolCallSection, type TraceToolDetails, type TraceToolResponseSection, type TraceToolResultSection, type TracingConfig, type TracingMode, type UnifiedMessage, type UserQuestionAnswer, type UserQuestionAnswerSet, type UserQuestionEvent, type UserQuestionItem, type UserQuestionOption, type UserQuestionResolution, type UserQuestionStatus, VertexProvider, type VertexProviderConfig, agentVerdictRule, appendBoundTools, buildSkillHeaderBlock, buildSubagentCatalogBlock, buildSystemPrompt, canOpenSkill, canSpawn, captureSnapshot, codePresenceRule, cognipeerSink, composeToolSets, countApproxTokens, countMessagesTokens, createAgent, createAgentNode, createAskUserQuestionTool, createBindSkillToolsTool, createCodeGuardrail, createContextSummarizeNode, createContextTools, createDelegateTool, createGetToolResponseTool, createGuardrail, createJsonGuardrail, createManageTodoTool, createOpenSkillTool, createParallelTool, createProvider, createRegexGuardrail, createResolverNode, createSkillRegistryRef, createSkillTools, createSmartAgent, createSpawnTool, createSubagentRegistryRef, createSubagentTools, createTool, createToolLimitFinalizeNode, createToolsNode, customCallbackRule, customSink, dedupeToolsByName, defaultTokenCounter, emptyUsage, evaluateGuardrails, fileSink, findSubagent, formatZodError, fromLangchainModel, fromLangchainTools, fromNativeProvider, generateSpanId, generateTraceId, getModelCapabilities, getNestedValue, getResolvedSmartConfig, getTokenCounter, hasToolResponseRecoveryReference, httpSink, isSmartModel, jsonSchemaRule, loadSkillsFromDisk, normalizeSmartAgentOptions, otlpSink, parseSkillFrontmatter, readMemoryFacts, regexRule, resolveAvailableSkills, resolveAvailableSubagents, resolveMemoryStore, resolveReasoning, resolveStrategy, resolveSubagentTools, resolveToolApprovalState, resolveUserQuestionState, restoreSnapshot, runSmartAgentEvalHarness, seedChildMessages, setTokenCounter, startStreamingSession, traceSessionToOtlp, validateReasoningConfig, withTools, withinDepth, writeSummaryFactsToMemory };