@cuylabs/agent-core 4.9.0 → 4.10.0

package/dist/index.d.ts

@@ -1,568 +1,67 @@
-import { H as HumanInputController, p as HumanInputConfig, T as Tool, M as Message, S as SessionManager, E as EffectiveAgentConfig, q as TurnChangeTracker, r as InterventionController, b as MiddlewareRunner, P as PromptBuilder, t as AgentTurnToolProvider, c as ToolExecutionMode, A as AgentEvent, u as StreamProvider, v as Scope, x as ScopeSnapshot, y as ScopeOptions, F as FileOperationMeta, z as AgentSignal, B as TypedHandler, U as Unsubscribe, W as WildcardHandler } from './instance-Bg61WSyz.js';
-export { C as Agent, G as AgentConfig, J as AgentDefaults, K as AgentDefaultsContext, L as AgentDefaultsProvider, N as AgentMiddleware, O as AgentModelHooks, Q as AgentStatus, V as AgentTurnActiveToolCall, X as AgentTurnBoundaryKind, Y as AgentTurnBoundaryMetadata, Z as AgentTurnBoundarySnapshot, _ as AgentTurnCommitApplier, $ as AgentTurnCommitBatch, a0 as AgentTurnCommitOptions, a1 as AgentTurnEngine, a2 as AgentTurnEngineOptions, a3 as AgentTurnPhase, a4 as AgentTurnResolvedToolCall, a5 as AgentTurnSource, a6 as AgentTurnSourceChatOptions, a7 as AgentTurnState, a8 as AgentTurnStateAdvanceOptions, a9 as AgentTurnStepCommitSnapshot, aa as AgentTurnStepCommitToolCall, ab as AgentTurnStepCommitToolResult, ac as AgentTurnStepRuntimeConfig, ad as AgentTurnToolContext, ae as AgentTurnToolProviderResult, e as AnyInferenceResult, af as AppliedProfile, ag as ApprovalAction, ah as ApprovalAgentMiddleware, ai as ApprovalCascadeMode, aj as ApprovalCascadePolicy, ak as ApprovalConfig, al as ApprovalCorrection, am as ApprovalDecision, an as ApprovalEvaluation, ao as ApprovalEvent, ap as ApprovalEventContext, aq as ApprovalHandler, ar as ApprovalLifecycleEvent, as as ApprovalMiddlewareConfig, at as ApprovalRememberScope, au as ApprovalRequest, av as ApprovalResolution, aw as ApprovalRule, ax as ApprovalRuleContext, ay as AssistantMessage, az as BlockedModelCall, aA as BranchEntry, aB as ChatLifecycleContext, aC as CommitOutputOptions, aD as CommitStepOptions, aE as CompactionConfig, aF as CompactionEntry, aG as CompatibleSchema, aH as ConfigChangeEntry, aI as CoordinatorNotification, aJ as CoordinatorNotificationKind, aK as CoordinatorRoundEvent, aL as CreateAgentTurnStateOptions, aM as CreateAgentTurnStepCommitBatchOptions, aN as CreateSessionOptions, aO as DEFAULT_AGENT_NAME, aP as DEFAULT_DISPATCH_TOOL_IDS, aQ as DEFAULT_LOCAL_DISPATCH_CONCURRENCY, aR as DEFAULT_LOCAL_DISPATCH_DEPTH, aS as DEFAULT_LOCAL_DISPATCH_TITLE_PREFIX, D as DEFAULT_MAX_OUTPUT_TOKENS, aT as DEFAULT_MAX_STEPS, D as DEFAULT_MAX_TOKENS, f as DEFAULT_RETRY_CONFIG, aU as DEFAULT_SYSTEM_PROMPT, aV as DISPATCH_STATES, aW as DispatchCheckOptions, aX as DispatchListOptions, aY as DispatchRecord, aZ as DispatchResult, a_ as DispatchRole, a$ as DispatchRuntime, b0 as DispatchStartInput, b1 as DispatchState, b2 as DispatchTarget, b3 as DispatchTargetInspection, b4 as DispatchTargetStartInput, b5 as DispatchTargetStartResult, b6 as DispatchTargetSummary, b7 as DispatchUsage, b8 as DoomLoopAction, b9 as DoomLoopHandler, ba as DoomLoopRequest, bb as EnhancedTools, bc as EntryBase, bd as EnvironmentInfo, be as ExternalTaskControl, bf as FileEntry, bg as GuidancePayload, bh as HistoryAccessor, bi as HumanInputEventContext, bj as HumanInputOption, bk as HumanInputRequest, bl as HumanInputRequestKind, bm as HumanInputRequestListOptions, bn as HumanInputRequestRecord, bo as HumanInputRequestStatus, bp as HumanInputResponse, bq as HumanInputTimeoutError, br as HumanInputToolArgs, bs as HumanInputUnavailableError, bt as IdleNotificationPayload, bu as InMemoryMailboxStore, bv as InMemoryTaskBoardStore, bw as InferSchemaOutput, g as InferenceCustomResult, h as InferenceStepInfo, I as InferenceStreamInput, i as InferenceStreamResult, bx as InputCheckResult, by as InstructionFile, bz as LocalDispatchRuntimeOptions, bA as LocalSessionTurnLock, bB as Mailbox, bC as MailboxStore, bD as MailboxSubscriber, bE as MemberRegisteredEvent, bF as MemberRuntime, bG as MemberStats, bH as MemberStatus, bI as MemberStatusChangedEvent, bJ as MessageBase, bK as MessageEntry, bL as MessageError, bM as MessageInput, bN as MessageKind, bO as MessageListFilter, bP as MessagePayload, bQ as MessageRole, bR as MessageSentEvent, bS as MetadataEntry, d as ModelCallContext, bT as ModelCallInput, bU as ModelCallOutput, bV as ModelFamily, bW as NormalizedToolReplayPolicy, bX as NotificationPriority, bY as OnFollowUpQueued, bZ as OnInterventionApplied, b_ as OtelMiddlewareConfig, b$ as PRUNE_PROTECTED_TOOLS, c0 as PendingIntervention, c1 as PermissionForwardedEvent, c2 as PermissionHandler, c3 as PermissionRequestPayload, c4 as PermissionResolvedEvent, c5 as PermissionResponsePayload, c6 as PlanCreatedEvent, c7 as PlannedTask, c8 as PrepareModelStepOptions, c9 as PreparedAgentModelStep, ca as PreparedExternalTask, cb as Profile, cc as PromptBuildContext, cd as PromptConfig, ce as PromptSection, cf as QueueTaskInput, cg as RecentMessagesOptions, ch as ReleaseSessionTurnLock, ci as RemoteSkillEntry, cj as RemoteSkillIndex, R as RetryConfig, j as RetryHandlerOptions, k as RetryState, ck as RiskLevel, cl as RuleSource, cm as RunModelStepOptions, cn as RunToolBatchOptions, co as RunToolBatchResult, cp as STORAGE_VERSION, cq as SerializedMessage, cr as Session, cs as SessionContext, ct as SessionEntry, cu as SessionHeader, cv as SessionInfo, cw as SessionStorage, cx as SessionTurnLock, cy as SessionTurnLockAcquireOptions, cz as ShutdownRequestPayload, cA as ShutdownRequestedEvent, cB as ShutdownResolvedEvent, cC as ShutdownResponsePayload, cD as SkillConfig, cE as SkillContent, cF as SkillDiscoveryError, cG as SkillDiscoveryResult, cH as SkillMetadata, cI as SkillRegistry, cJ as SkillResource, cK as SkillResourceType, cL as SkillScope, cM as SkillSource, cN as SkillSourceType, cO as StepProcessingOptions, cP as StepProcessingOutput, cQ as StepProcessingResult, cR as StreamChunk, cS as StreamInput, cT as StreamProviderConfig, cU as StreamProviderFactory, cV as StreamProviderInput, cW as StreamProviderResult, cX as SynthesisCompleteEvent, cY as SynthesisResult, cZ as SystemMessage, c_ as TERMINAL_STATUSES, c$ as TaskAbortedEvent, d0 as TaskBoard, d1 as TaskBoardStore, d2 as TaskCompletedEvent, d3 as TaskCompletion, d4 as TaskConflictError, d5 as TaskCreateInput, d6 as TaskCreatedEvent, d7 as TaskDispatchMode, d8 as TaskExecutor, d9 as TaskExecutorInput, da as TaskFailedEvent, db as TaskListFilter, dc as TaskResult, dd as TaskStatus, de as TaskTransition, df as TaskTransitionEvent, dg as TaskTransitionReason, dh as TeamCoordinatorConfig, di as TeamEvent, dj as TeamMember, dk as TeamMessage, dl as TeamNotificationEvent, dm as TeamPlan, dn as TeamSnapshot, dp as TeamStartedEvent, dq as TeamStoppedEvent, dr as TeamTask, ds as TelemetryConfig, dt as TelemetryConfigResult, du as TokenUsage, dv as ToolCallDecision, dw as ToolCallOutput, dx as ToolCapabilities, dy as ToolContext, dz as ToolHostRequirements, dA as ToolMessage, dB as ToolMetadata, dC as ToolReplayMode, dD as ToolReplayPolicy, dE as ToolResult, dF as ToolSideEffectLevel, dG as TracingConfig, a as TurnTrackerContext, dH as UndoResult, dI as UserMessage, dJ as WorkerReportPayload, dK as accumulateUsage, dL as advanceAgentTurnState, dM as approvalMiddleware, dN as buildCoordinatorNotificationEvent, l as calculateDelay, dO as createAgent, dP as createAgentTurnEngine, dQ as createAgentTurnState, dR as createApprovalHandler, dS as createHumanInputController, dT as createPromptBuilder, m as createRetryHandler, n as createRetryState, dU as createSkillRegistry, dV as createTurnTracker, dW as emptySkillRegistry, dX as failAgentTurnState, dY as getRequiredToolHost, dZ as isApprovalMiddleware, d_ as isBlockedModelCall, d$ as isHumanInputController, e0 as requiresToolHost, e1 as resolveAgentDefaults, e2 as resolveCapability, e3 as sandboxDefaultsProvider, s as shouldRetry, w as withRetry } from './instance-Bg61WSyz.js';
-import { LanguageModel, ModelMessage, Tool as Tool$1, TelemetryOptions } from 'ai';
-import { T as ToolHost } from './types-C_LCeYNg.js';
-export { D as DirEntry, E as ExecOptions, a as ExecResult, F as FileStat } from './types-C_LCeYNg.js';
-import { L as Logger } from './types-RSCv7nQ4.js';
-export { C as ConsoleLoggerOptions, F as FileLoggerOptions, a as LogLevel, b as LogMeta } from './types-RSCv7nQ4.js';
-import { R as ReasoningLevel } from './types-CQaXbRsS.js';
-export { E as EXTENDED_LEVELS, F as FIXED_LEVELS, a as ReasoningConfig, S as STANDARD_LEVELS, s as shouldIncludeReasoningSummary } from './types-CQaXbRsS.js';
-export { ExecuteAgentToolCallOptions, ExecuteAgentToolCallResult, MAX_BYTES, MAX_LINES, ToolRegistry, ToolSearchOptions, ToolSpec, TruncateResult, createToolSearchTool, defaultRegistry, executeAgentToolCall, normalizeToolReplayPolicy, truncateOutput } from './tool/index.js';
-export { ToolHostProvider, ToolHostProviderSummary, ToolHostRegistry, defaultToolHostRegistry, localHost } from './tool/host/index.js';
-export { AdapterSettings, CacheCapabilitySource, CapabilityCache, CapabilityOverrides, Directory, EngineSpec, ModelCapabilityResolver, ModelSpec, NetworkStatus, PatternCapabilitySource, RemoteCapabilityFetcher, RemoteCapabilitySource, ResolutionResult, Resolver, applyCapabilityOverride, configureResolver, createResolver, extractModelId, extractProvider, findCapabilityOverride, getDefaultResolver, getModelId, getNetworkStatus, getProviderCompatibility, getProviderId, inferContextWindow, inferProvider, likelySupportsReasoning } from './models/index.js';
-export { C as CapabilitySource, D as DEFAULT_RESOLVER_OPTIONS, I as InputModality, M as ModelCapabilities, a as ModelEntry, O as OutputModality, P as ProviderCompatibility, R as ResolverOptions, S as SourcePriority, b as SourceResult, c as buildAnthropicOptions, d as buildBedrockOptions, e as buildGoogleOptions, f as buildGroqOptions, g as buildOpenAIOptions, h as buildOpenRouterOptions, i as buildReasoningOptions, j as buildReasoningOptionsSync, k as buildXAIOptions, l as getProviderOptionsKey, m as getReasoningConfig, n as getReasoningConfigSync, s as supportsReasoning, o as supportsReasoningSync } from './index-BCqEGzBj.js';
-export { H as HttpTransportConfig, M as MCPConfig, a as MCPManager, b as MCPPromptInfo, c as MCPResourceInfo, d as MCPResourceTemplateInfo, e as MCPServerConfig, f as MCPServerStatus, R as RemoteTransportConfig, S as SseTransportConfig, g as StdioTransportConfig } from './types-DMjoFKKv.js';
-export { ClientCredentialsOptions, ClientCredentialsProvider, DiagnosticFetchOptions, ServiceAccountServerConfig, ServiceAccountServerOptions, createDiagnosticFetch, createMCPManager, httpServer, serviceAccountServer, sseServer, stdioServer } from './mcp/index.js';
-export { AgentTaskChatAdapter, AgentTaskCheckpointReason, AgentTaskCheckpointStrategy, AgentTaskCheckpointStrategyInput, AgentTaskExecutionCheckpoint, AgentTaskExecutionContext, AgentTaskExecutionRun, AgentTaskExecutionSnapshot, AgentTaskObserver, AgentTaskPayload, AgentTaskResult, AgentTaskResumeSnapshot, AgentTaskRunner, AgentTaskRunnerOptions, AgentWorkflowAssistantMessageSnapshot, AgentWorkflowCommitResult, AgentWorkflowInputCommitPlan, AgentWorkflowInterventionSnapshot, AgentWorkflowMessageSnapshot, AgentWorkflowModelStepPlan, AgentWorkflowModelStepResult, AgentWorkflowOperationPlan, AgentWorkflowOutputCommitPlan, AgentWorkflowReplayDecision, AgentWorkflowStepCommitPlan, AgentWorkflowSystemMessageSnapshot, AgentWorkflowToolBatchPlan, AgentWorkflowToolBatchResult, AgentWorkflowToolCallPlan, AgentWorkflowToolCallResult, AgentWorkflowToolCallSnapshot, AgentWorkflowToolMessageSnapshot, AgentWorkflowTurnPhase, AgentWorkflowTurnState, AgentWorkflowUserMessageSnapshot, ContextOverflowError, CreateAgentWorkflowTurnStateOptions, DoomLoopError, applyAgentWorkflowCommitResult, applyAgentWorkflowModelStepResult, applyAgentWorkflowToolBatchResult, applyAgentWorkflowToolCallResult, applyWorkflowInterventions, cloneAgentWorkflowTurnState, commitOutput, commitStep, createAgentTaskRunner, createAgentTurnStepCommitBatch, createAgentWorkflowTurnState, defaultAgentTaskCheckpointStrategy, drainWorkflowInterventions, failAgentWorkflowTurnState, planNextAgentWorkflowOperation, prepareModelStep, processStepStream, queueWorkflowFollowUps, recordAgentWorkflowReplayDecision, restoreAgentWorkflowMessage, restoreAgentWorkflowMessages, runModelStep, runToolBatch, snapshotAgentWorkflowMessage, snapshotAgentWorkflowMessages } from './execution/index.js';
-export { c as convertAgentMessagesToModelMessages } from './model-messages-n_ZMZwIm.js';
-export { CacheTTL, PromptCacheConfig, createTelemetryConfig, otelMiddleware, promptCacheMiddleware } from './middleware/index.js';
-export { DEFAULT_INSTRUCTION_PATTERNS, DEFAULT_MAX_DEPTH, DEFAULT_MAX_FILE_SIZE, PRIORITY_BASE, PRIORITY_CUSTOM, PRIORITY_ENVIRONMENT, PRIORITY_INSTRUCTIONS, PRIORITY_OVERRIDE, PRIORITY_SKILLS, detectModelFamily, discoverInstructions, formatEnvironment, formatInstructions, gatherEnvironment, getAvailableFamilies, getTemplate, loadGlobalInstructions, summarizeEnvironment } from './prompt/index.js';
-export { Profiles, applyProfile, careful, code, createProfile, explore, filterTools, mergeProfiles, plan, quick, review, watch } from './profiles/index.js';
-export { SandboxPreview, SandboxProvider, SandboxSession, SandboxSessionMetadata, SandboxSnapshotResult } from './sandbox/index.js';
-export { Inference, buildModelCallContext, buildToolSet, stream, streamOnce, streamStep } from './inference/index.js';
-export { BuildRecentMessagesOptions, FileStorage, FileStorageOptions, MemoryStorage, buildEntryPath, buildMessagesFromEntries, buildRecentMessagesFromEntries, buildRecentMessagesFromEntryMap, configureDefaultSessionManager, createMessageEntry, createMetadataEntry, deserializeMessage, extractSessionInfo, generateEntryId, getDataDir, getDefaultSessionManager, getGitRootHash, getLeafId, getProjectId, getProjectSessionsDir, getSessionsDir, parseJSONL, serializeMessage, toJSONL, toJSONLBatch } from './storage/index.js';
-export { ApprovalDeniedError, ApprovalPolicyPresetName, ApprovalPolicyPresetOptions, ApprovalRuleCondition, ApprovalTimeoutError, RiskTierApprovalPolicyOptions, ThresholdApprovalRuleOptions, TrustedSessionApprovalPolicyOptions, allApprovalConditions, anyApprovalConditions, approvalRequestsOverlap, buildApprovalRuleContext, createApprovalCorrection, createApprovalPolicyPreset, createConditionalApprovalRule, createDangerouslyAllowAllApprovalPolicy, createHeadlessDenyApprovalPolicy, createInteractiveApprovalPolicy, createRememberedApprovalRules, createRiskTierApprovalPolicy, createThresholdApprovalRule, createTrustedSessionApprovalPolicy, describeApprovalOperation, extractApprovalPatterns, formatApprovalDeniedReason, getToolRisk, matchApprovalArgValue, matchApprovalNumericArg, matchApprovalPattern, matchApprovalRisks, matchApprovalSessions, matchApprovalStringPrefixes, normalizeApprovalCascadePolicy, normalizeRememberScopes, selectRememberScope, shouldCascadeApprovalDecision } from './safety/index.js';
-export { E as ErrorCategory, L as LLMError, a as LLMErrorOptions, R as ResponseHeaders } from './llm-error-D93FNNLY.js';
-export { getErrorCategory, getRetryDelay, isRetryable, isRetryableCategory, parseRetryDelay } from './inference/errors/index.js';
-export { DEFAULT_EXTERNAL_DIRS, DEFAULT_MAX_SCAN_DEPTH, DEFAULT_SKILL_MAX_SIZE, SKILL_FILENAME, createSkillResourceTool, createSkillTool, createSkillTools, discoverSkills, inferResourceType, loadResourceContent, loadSkillContent, loadSkillMetadata, parseFrontmatter } from './skill/index.js';
-export { CompositeDispatchTaskExecutorOptions, DispatchExternalTaskControlOptions, DispatchTaskExecutorOptions, DispatchTaskExecutorRoute, RuntimeDispatchExecutorOptions, RuntimeDispatchTargetOptions, createCompositeDispatchTaskExecutor, createDispatchExternalTaskControl, createDispatchTaskExecutor, createDispatchTools, createLocalDispatchRuntime, createRuntimeDispatchExecutor, createRuntimeDispatchTargets, ensureNonEmpty, mergeInspection } from './dispatch/index.js';
-export { DEFAULT_SUBAGENT_CONCURRENCY, DEFAULT_SUBAGENT_DEPTH, DEFAULT_SUBAGENT_SESSION_PREFIX, DiscoveredSubAgentRole, LOCAL_SUBAGENT_BACKEND, MarkdownSubAgentRole, MarkdownSubAgentRoleFrontmatter, ParsedMarkdownSubAgentRole, ParsedSubAgentToolSpec, SUBAGENT_TOOL_IDS, SubAgentCompletedResult, SubAgentConfig, SubAgentRole, SubAgentRoleDiscoveryOptions, SubAgentRoleDiscoveryResult, SubAgentRoleResolvers, SubAgentRoleSource, SubAgentToolModifier, SubAgentToolsOptions, clearInstalledSubAgents, configureSubAgents, createCloseAgentTool, createInvokeAgentTool, createSubAgentTools, createWaitAgentTool, discoverSubAgentRoles, formatAsyncSpawnedResult, formatCancelledAgentResult, formatCloseAlreadyResolvedResult, formatCloseMissingAgentResult, formatInvalidAgentTypeResult, formatMissingAgentsResult, formatSpawnBlockedResult, formatSyncSubAgentErrorResult, formatSyncSubAgentResult, formatWaitErrorResult, formatWaitResult, formatWaitTimeoutResult, getConfiguredSubAgents, getInstalledSubAgentBackend, getProjectSubAgentRolesDir, getUserSubAgentRolesDir, installLocalSubAgents, installSubAgentTools, isMarkdownSubAgentRole, parseMarkdownSubAgentRole, parseSubAgentRoleFrontmatter, parseSubAgentToolSpec, toSubAgentRole } from './subagents/index.js';
-export { DefinePluginInit, DiscoveredPlugin, LayeredSettings, NullSettings, PluginActivateContext, PluginCapabilityTag, PluginCommand, PluginCommandMetadata, PluginCompatibility, PluginContext, PluginContributions, PluginDefinition, PluginEventBus, PluginEventBusAPI, PluginEventHandler, PluginInit, PluginLifecycleHooks, PluginLoaderOptions, PluginManifest, PluginRegistry, PluginRegistryCompatibilityOptions, PluginRegistryOptions, PluginRegistryTimeoutOptions, PluginSessionContext, PluginSettingsDefinition, PluginSettingsProvider, PluginSettingsSchema, PluginSurfaceContract, PluginUnsubscribe, StaticSettings, ValidatedSettings, definePlugin, discoverPlugins, getPluginLoader, isDefinedPlugin, loadPluginModule, resetFrameworkAliases, resetPluginLoader, resolveFrameworkAliases } from './plugin/index.js';
-export { EventBus, EventBusMessage, EventBusOptions, EventBusSubscribeOptions, EventBusSubscription, createEventBus } from './events/index.js';
-export { ApprovalForwarder, CoordinatorInboxItem, CoordinatorLoopOptions, CoordinatorLoopResult, CoordinatorRosterMember, CoordinatorRound, CoordinatorRoundTransition, CoordinatorRoundTransitionInput, CoordinatorRuntimeStatus, CoordinatorStatus, CoordinatorTaskNotificationLike, CoordinatorWorkerReportLike, TeamCoordinator, TeamPermissionPolicyConfig, TeamPermissionRule, WorkerReport, addTokenUsage, buildCoordinatorSystemPrompt, coordinatorToolDescriptions, createTeamCoordinator, evaluateCoordinatorRoundTransition, formatCoordinatorRoundMessage, formatCoordinatorTaskNotifications, formatCoordinatorWorkerReports, teamPermissionPolicy } from './team/index.js';
-export { createConsoleLogger, createFileLogger, silentLogger } from './logger/index.js';
-import 'zod';
-import '@ai-sdk/provider-utils';
-import '@modelcontextprotocol/sdk/client/auth.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
-import 'jiti';
-
 /**
- * Promise-based sleep utility.
- *
- * @param ms - Duration to wait in milliseconds.
- */
-declare function sleep(ms: number): Promise<void>;
-
-/**
- * Backward-compatible alias for the controller-backed human input primitive.
- *
- * Prefer `createHumanInputController(...)` in new code.
- */
-type HumanInputHandler = HumanInputController;
-/**
- * Backward-compatible alias for `createHumanInputController(...)`.
- *
- * Prefer `createHumanInputController(...)` in new code.
- */
-declare function createHumanInputHandler(config?: HumanInputConfig): HumanInputHandler;
-
-interface CreateHumanInputToolOptions extends HumanInputConfig {
-    controller?: HumanInputController;
-    name?: string;
-    description?: string;
-}
-declare function createHumanInputTool(options?: CreateHumanInputToolOptions): Tool.AnyInfo;
-declare function createHumanInputToolWithController(controller?: HumanInputController, options?: Pick<CreateHumanInputToolOptions, "name" | "description">): Tool.AnyInfo;
-/**
- * Backward-compatible alias for `createHumanInputToolWithController(...)`.
- *
- * Prefer the controller name in new code.
- */
-declare const createHumanInputToolWithHandler: typeof createHumanInputToolWithController;
-
-/**
- * Mutable runtime state held by an `Agent` instance.
- *
- * Only fields that are actually read at runtime belong here.
- * Configuration-level values (systemPrompt, cwd) live on
- * `EffectiveAgentConfig`; computed values (isStreaming) are
- * derived from instance counters.
- */
-interface AgentState {
-    model: LanguageModel;
-    /** Current reasoning level */
-    reasoningLevel: ReasoningLevel;
-}
-
-/**
- * Token Estimation Utilities
- *
- * Provides lightweight heuristic-based token counting for messages
- * and conversations. Uses the chars/4 approximation — simple but
- * effective for context-window planning decisions.
- *
- * These are *estimates*, not exact counts. For billing or hard limits,
- * use the provider's native tokeniser instead.
- */
-
-/**
- * Estimate token count for a plain string.
- *
- * Uses the widely-accepted `chars / 4` heuristic.
- *
- * @param text - Text to estimate
- * @returns Estimated token count (always ≥ 1 for non-empty input)
- */
-declare function estimateTokens(text: string): number;
-/**
- * Estimate token count for a single message.
- *
- * Handles:
- * - Plain string content
- * - Multi-part / multimodal arrays (text parts + images)
- *
- * @param message - A `Message` (internal) or `ModelMessage` (AI SDK)
- * @returns Estimated token count
- */
-declare function estimateMessageTokens(message: Message | ModelMessage): number;
-/**
- * Estimate total tokens for an entire conversation.
- *
- * Adds a small per-message overhead (≈ 4 tokens) for message
- * framing (`role`, delimiters, etc.).
- *
- * @param messages - Array of messages to estimate
- * @returns Estimated total token count
- */
-declare function estimateConversationTokens(messages: (Message | ModelMessage)[]): number;
-
-/**
- * Context Overflow Detection & Pruning
- *
- * Detects when a conversation is approaching the model's context-window
- * limit and prunes old / redundant content to stay within bounds.
- *
- * Two pruning strategies are available:
- * 1. **Tool-result pruning** — replaces large, stale tool outputs with
- *    compact placeholders (lightweight, no model call).
- * 2. **Conversation cutting** — identifies a safe cut-point and removes
- *    older messages entirely (optionally summarised by the manager).
- */
-
-/**
- * Context limits configuration.
- *
- * All values are in *estimated* tokens (see {@link estimateTokens}).
- */
-interface ContextLimits {
-    /** Maximum context window size in tokens */
-    contextWindow: number;
-    /** Reserve tokens for output generation */
-    reserveTokens: number;
-    /** Protect this many recent tokens from pruning */
-    protectedTokens: number;
-    /** Minimum tokens to trigger pruning (avoid pruning tiny contexts) */
-    pruneMinimum: number;
-}
-/**
- * Default context limits.
- * Based on typical 128 k context-window models.
- */
-declare const DEFAULT_CONTEXT_LIMITS: ContextLimits;
-/**
- * Compute the usable token budget: the context window minus reserved output tokens.
- *
- * This is the single formula for the "safe input threshold" used by
- * overflow detection, auto-compaction event emission, and step-processing limits.
- */
-declare function getUsableTokenLimit(limits: Pick<ContextLimits, "contextWindow" | "reserveTokens">): number;
-/**
- * Result of a pruning operation.
- */
-interface PruneResult {
-    /** Messages after pruning (may include a summary message) */
-    messages: Message[];
-    /** Number of messages removed */
-    removedCount: number;
-    /** Estimated tokens removed */
-    tokensRemoved: number;
-    /** Whether summarisation was used */
-    summarized: boolean;
-    /** The summary content, if generated */
-    summary?: string;
-}
-/**
- * Find a safe index at which the conversation can be "cut".
- *
- * Rules:
- * - Never cut in the middle of a tool-call sequence
- * - Prefer cutting after assistant / user messages
- * - Keep at least {@link protectedTokens} tokens at the end
- *
- * @param messages       - Full message array
- * @param protectedTokens - Tokens to preserve at the end
- * @returns Cut index (exclusive — remove messages *before* this index).
- *          Returns `0` when no safe cut-point exists.
- */
-declare function findCutPoint(messages: Message[], protectedTokens?: number): number;
-
-/**
- * Context Manager
- *
- * Stateful wrapper around the context-management primitives.
- * Tracks per-session context limits and provides a single entry
- * point for token estimation, overflow detection, and pruning.
- */
-
-/**
- * Per-session context manager.
- *
- * Holds the active context-window limits and provides convenience
- * methods for checking, reporting, and pruning context.
- *
- * @example
- * ```typescript
- * const ctx = new ContextManager({ limits: { contextWindow: 200_000 } });
- *
- * if (ctx.shouldPrune(messages)) {
- *   const result = await ctx.prune(messages);
- *   console.log(`Removed ${result.removedCount} messages`);
- * }
- * ```
- */
-declare class ContextManager {
-    private limits;
-    private model?;
-    private summaryPrompt?;
-    constructor(options?: {
-        limits?: Partial<ContextLimits>;
-        model?: LanguageModel;
-        summaryPrompt?: string;
-    });
-    /** Get a copy of the current context limits. */
-    getLimits(): ContextLimits;
-    /** Update context limits (e.g. when switching models). */
-    setLimits(limits: Partial<ContextLimits>): void;
-    /** Set the model used for summarisation. */
-    setModel(model: LanguageModel): void;
-    /** Estimate total tokens for a message array. */
-    estimateTokens(messages: (Message | ModelMessage)[]): number;
-    /** Check whether the context is overflowing. */
-    isOverflowing(messages: (Message | ModelMessage)[]): boolean;
-    /** Check whether pruning should be triggered. */
-    shouldPrune(messages: (Message | ModelMessage)[]): boolean;
-    /** Prune context to fit within limits. */
-    prune(messages: Message[]): Promise<PruneResult>;
-    /**
-     * Get a snapshot of token statistics.
-     *
-     * Useful for dashboards, logging, or deciding whether to prune.
-     */
-    getStats(messages: (Message | ModelMessage)[]): {
-        tokens: number;
-        limit: number;
-        available: number;
-        utilizationPercent: number;
-        isOverflowing: boolean;
-        shouldPrune: boolean;
-    };
-}
-
-/** Everything the chat loop needs from the Agent instance. */
-interface ChatLoopDeps {
-    sessionId: string;
-    turnId: string;
-    message: string;
-    abort: AbortSignal;
-    systemOverride?: string;
-    sessions: SessionManager;
-    /**
-     * Live reference to the agent's tools Map.
-     *
-     * The loop rebuilds a `Record<string, Tool.Info>` from this Map at
-     * the start of each model step so that mid-turn additions (e.g.
-     * tools loaded by `tool_search` via `agent.addTool()`) are visible
-     * to the next step without restarting the turn.
-     */
-    tools: Map<string, Tool.AnyInfo>;
-    config: EffectiveAgentConfig;
-    turnTracker: TurnChangeTracker;
-    interventionCtrl: InterventionController;
-    middlewareRunner: MiddlewareRunner;
-    contextManager: ContextManager;
-    rememberedDoomLoopTools: Set<string>;
-    reasoningLevel: ReasoningLevel;
-    promptBuilder?: PromptBuilder;
-    host: ToolHost;
-    humanInputController?: HumanInputController;
-    mcpTools: Record<string, Tool$1>;
-    turnToolProviders: AgentTurnToolProvider[];
-    telemetrySettings?: TelemetryOptions;
-    toModelMessages: (messages: Message[]) => ModelMessage[];
-    setIsStreaming: (value: boolean) => void;
-    /**
-     * Tool execution mode for this chat loop.
-     * - `"auto"` — tools auto-execute via AI SDK (default)
-     * - `"plan"` — tools are planned, then dispatched via `runToolBatch()`
-     */
-    toolExecutionMode?: ToolExecutionMode;
-    /** Logger for diagnostic output. */
-    logger?: Logger;
-}
-
-/**
- * Run the core chat loop: input commit → step loop → output commit →
- * auto-compaction → turn summary → complete.
- */
-declare function runChatLoop(deps: ChatLoopDeps): AsyncGenerator<AgentEvent>;
-
-declare function ensureSessionLoaded(options: {
-    sessionId: string;
-    sessions: SessionManager;
-    cwd: string;
-}): Promise<void>;
-
-/**
- * CLI-friendly event printer for `agent.chat()` streams.
- *
- * Provides a zero-config function that handles the full `AgentEvent`
- * union, writing text deltas to stdout, tool calls with emoji prefixes,
- * and lifecycle events to stderr.  Covers the same ground as the
- * 80-line `handleEvent()` in example 03–streaming but as a reusable
- * one-liner:
- *
- * ```ts
- * const print = createEventPrinter();
- * for await (const event of agent.chat("demo", "Hello")) {
- *   print(event);
- * }
- * ```
- *
- * All options are optional — sensible defaults work out of the box.
- */
-
-/** Controls which event categories the printer renders. */
-interface EventPrinterOptions {
-    /**
-     * Show tool start/result/error events.
-     * @default true
-     */
-    tools?: boolean;
-    /**
-     * Show reasoning tokens (thinking models like o3, o4-mini).
-     * @default true
-     */
-    reasoning?: boolean;
-    /**
-     * Show step/lifecycle banners.
-     * @default false
-     */
-    steps?: boolean;
-    /**
-     * Show approval, intervention, and safety events.
-     * @default true
-     */
-    safety?: boolean;
-    /**
-     * Show the completion summary line.
-     * @default true
-     */
-    completion?: boolean;
-    /**
-     * Show team coordination events (team-*).
-     * @default false
-     */
-    team?: boolean;
-    /**
-     * Writable stream for text output.
-     * @default process.stdout
-     */
-    stdout?: NodeJS.WritableStream;
-    /**
-     * Writable stream for diagnostic/lifecycle output.
-     * @default process.stderr
-     */
-    stderr?: NodeJS.WritableStream;
-}
-/**
- * Create a stateless event handler for printing `AgentEvent`s to the
- * terminal.
- *
- * @param options - Fine-tune which event categories are rendered.
- * @returns A function that accepts one `AgentEvent` and writes to stdout/stderr.
- *
- * @example
- * ```ts
- * import { createAgent, createEventPrinter } from "@cuylabs/agent-core";
- *
- * const agent = createAgent({ model, systemPrompt: "Be concise." });
- * const print = createEventPrinter();
- *
- * for await (const event of agent.chat("demo", "Hello")) {
- *   print(event);
- * }
- * ```
- *
- * @example
- * ```ts
- * // Quiet mode — text only, no tool or lifecycle output
- * const print = createEventPrinter({
- *   tools: false,
- *   reasoning: false,
- *   steps: false,
- *   completion: false,
- * });
- * ```
- */
-declare function createEventPrinter(options?: EventPrinterOptions): (event: AgentEvent) => void;
-
-/**
- * Auto-detect and configure stream provider from model and tools.
- *
- * Returns the configured stream provider, or undefined if standard
- * AI SDK streaming should be used.
- */
-declare function autoDetectStreamProvider(model: LanguageModel, tools: unknown, explicitProvider: unknown): StreamProvider | undefined;
-
-/**
- * Shared intervention/follow-up types for @cuylabs/agent-core.
- *
- * These types give runtimes (agent-server, agent-runtime-dapr) a common
- * vocabulary for user-directed turn control:
- * - immediate mid-turn steering
- * - deferred follow-ups queued for the next turn
- *
- * The `InterventionController` remains the in-process implementation;
- * these types are the protocol-level representation for cross-process
- * and durable scenarios.
- */
-/**
- * A steering request surfaced to runtime consumers.
- *
- * Created when a client calls `steerTurn()` (agent-server) or
- * `POST /agents/:id/steer` (agent-runtime-dapr). Runtimes publish
- * an `intervention-applied` event so UIs can show the injection.
- */
-interface SteeringRequest {
-    /** Unique identifier (maps to `PendingIntervention.id` in direct mode) */
-    id: string;
-    /** Session the steering targets */
-    sessionId: string;
-    /** The user message to inject */
-    message: string;
-    /** When the steering was requested */
-    timestamp: number;
-}
-/**
- * Acknowledgement returned after a steering message is accepted.
- *
- * In direct mode, the message is already queued in the
- * `InterventionController`. In durable mode, it is persisted in
- * state and will be picked up at the next workflow activity boundary.
- */
-interface SteeringResponse {
-    /** The steering request ID */
-    id: string;
-    /** Whether the message was accepted */
-    accepted: boolean;
-}
-/**
- * A deferred follow-up request surfaced to runtime consumers.
- *
- * Created when a client calls `followUpTurn()` (agent-server) or
- * `POST /agents/:id/follow-up` (agent-runtime-dapr). Runtimes publish
- * a `follow-up-queued` event so UIs can show that the message will be
- * available after the current turn completes.
- */
-interface FollowUpRequest {
-    /** Unique identifier (maps to `PendingIntervention.id` in direct mode) */
-    id: string;
-    /** Session the follow-up targets */
-    sessionId: string;
-    /** The user message to queue for the next turn */
-    message: string;
-    /** When the follow-up was requested */
-    timestamp: number;
-}
-/**
- * Acknowledgement returned after a follow-up message is accepted.
- *
- * In direct mode, the message is queued in the `InterventionController`.
- * In durable mode, it is persisted in the runtime's durable follow-up store
- * and becomes seedable on the next turn for the same session.
- */
-interface FollowUpResponse {
-    /** The follow-up request ID */
-    id: string;
-    /** Whether the message was accepted */
-    accepted: boolean;
-}
-
-type FollowUpMode = "suggest" | "confirm" | "auto-run";
-type FollowUpStatus = "queued" | "accepted" | "discarded" | "applied";
-type FollowUpDecisionAction = "accept" | "discard";
-interface FollowUpPolicy {
-    /**
-     * `suggest`:
-     *   queue the follow-up and expose it for the host/UI to surface.
-     * `confirm`:
-     *   queue it, but require an explicit accept/discard decision before seeding.
-     * `auto-run`:
-     *   automatically seed the next turn with queued follow-ups for the session.
-     */
-    mode?: FollowUpMode;
-}
-interface QueuedFollowUpRecord {
-    id: string;
-    sessionId: string;
-    message: string;
-    createdAt: string;
-    updatedAt: string;
-    mode: FollowUpMode;
-    status: FollowUpStatus;
-    sourceTurnId?: string;
-    workflowInstanceId?: string;
-    decidedAt?: string;
-    appliedAt?: string;
-    seededTurnId?: string;
-}
-declare function normalizeFollowUpMode(mode?: FollowUpMode): FollowUpMode;
-declare function createQueuedFollowUpRecord(request: FollowUpRequest, options?: {
-    mode?: FollowUpMode;
-    sourceTurnId?: string;
-    workflowInstanceId?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}): QueuedFollowUpRecord;
-declare function resolveQueuedFollowUp(record: QueuedFollowUpRecord, action: FollowUpDecisionAction, updatedAt: string): QueuedFollowUpRecord;
-declare function markQueuedFollowUpApplied(record: QueuedFollowUpRecord, updatedAt: string, seededTurnId?: string): QueuedFollowUpRecord;
-declare function canSeedQueuedFollowUp(record: QueuedFollowUpRecord): boolean;
-
-declare function currentScope(): Scope | undefined;
-declare function snapshotScope(scope?: Scope | undefined): ScopeSnapshot | undefined;
-declare function withinScope<T>(options: ScopeOptions, fn: () => T | Promise<T>): Promise<T>;
-declare function restoreScope<T>(snapshot: ScopeSnapshot | undefined, fn: () => T | Promise<T>): Promise<T>;
-
-/**
- * Extract file paths from tool arguments based on metadata.
- */
-declare function extractFilePathsFromArgs(args: Record<string, unknown>, meta: FileOperationMeta): string[];
-/**
- * Check whether a tool operation should trigger baseline capture.
- */
-declare function shouldCaptureBaseline(meta: FileOperationMeta): boolean;
-
-/**
- * LocalSignal — in-process event dispatch.
- *
- * Dispatches events synchronously via direct function calls.
- * Zero dependencies, zero serialization, zero network.
- *
- * Handler errors are caught silently — a broken listener must never
- * interrupt the agent's streaming pipeline.
- */
-
-declare class LocalSignal implements AgentSignal {
-    /** type → Set<handler> for typed subscriptions */
-    private readonly typed;
-    /** handlers that receive every event */
-    private readonly wildcard;
-    on<T extends AgentEvent["type"]>(type: T, handler: TypedHandler<T>): Unsubscribe;
-    onAny(handler: WildcardHandler): Unsubscribe;
-    emit(event: AgentEvent): void;
-    clear(): void;
-}
-
-export { AgentEvent, AgentSignal, type AgentState, AgentTurnToolProvider, type ChatLoopDeps, type ContextLimits, ContextManager, type CreateHumanInputToolOptions, DEFAULT_CONTEXT_LIMITS, EffectiveAgentConfig, type EventPrinterOptions, FileOperationMeta, type FollowUpDecisionAction, type FollowUpMode, type FollowUpPolicy, type FollowUpRequest, type FollowUpResponse, type FollowUpStatus, HumanInputConfig, HumanInputController, type HumanInputHandler, InterventionController, LocalSignal, Logger, Message, MiddlewareRunner, PromptBuilder, type QueuedFollowUpRecord, ReasoningLevel, ScopeSnapshot, SessionManager, type SteeringRequest, type SteeringResponse, StreamProvider, Tool, ToolExecutionMode, ToolHost, TurnChangeTracker, autoDetectStreamProvider, canSeedQueuedFollowUp, createEventPrinter, createHumanInputHandler, createHumanInputTool, createHumanInputToolWithController, createHumanInputToolWithHandler, createQueuedFollowUpRecord, currentScope, ensureSessionLoaded, estimateConversationTokens, estimateMessageTokens, estimateTokens, extractFilePathsFromArgs, findCutPoint, getUsableTokenLimit, markQueuedFollowUpApplied, normalizeFollowUpMode, resolveQueuedFollowUp, restoreScope, runChatLoop, shouldCaptureBaseline, sleep, snapshotScope, withinScope };
+ * @cuylabs/agent-core
+ *
+ * Embeddable AI agent infrastructure using the Vercel AI SDK.
+ *
+ * This root barrel re-exports from each module barrel.
+ * Prefer focused subpath imports when you want the import path
+ * to match the concept you're working with:
+ *
+ *   @cuylabs/agent-core/tool       — Tool, ToolRegistry
+ *   @cuylabs/agent-core/models     — resolver, identifiers, capabilities
+ *   @cuylabs/agent-core/mcp        — MCP server integration
+ *   @cuylabs/agent-core/execution  — task, scope, turn, workflow primitives
+ *   @cuylabs/agent-core/execution/turn — turn state, engine, runner
+ *   @cuylabs/agent-core/execution/workflow — durable workflow state/planner
+ *   @cuylabs/agent-core/middleware  — approval, telemetry, prompt-cache
+ *   @cuylabs/agent-core/prompt     — builder, templates, instructions
+ *   @cuylabs/agent-core/reasoning  — level config, provider builders
+ *   @cuylabs/agent-core/tool/host  — tool execution host interfaces and local host
+ *   @cuylabs/agent-core/sandbox    — managed environment sessions above ToolHost
+ *   @cuylabs/agent-core/storage    — sessions, file/memory backends
+ *   @cuylabs/agent-core/skill      — discovery, loading, registry
+ *   @cuylabs/agent-core/events     — typed signals and channel event bus
+ *   @cuylabs/agent-core/execution/scope — ambient execution context
+ *   @cuylabs/agent-core/errors     — LLMError, classification, retry
+ *   @cuylabs/agent-core/profiles   — built-in & custom presets
+ *   @cuylabs/agent-core/safety     — approval handler, risk levels
+ *   @cuylabs/agent-core/inference  — model streaming, toolset bridge
+ *   @cuylabs/agent-core/context    — context fragments, window management, compaction helpers
+ *   @cuylabs/agent-core/memory     — durable memory providers, middleware, and tools
+ *   @cuylabs/agent-core/tracking   — turn tracker, file diffs
+ *   @cuylabs/agent-core/dispatch   — async dispatch control plane, runtime adapters
+ *   @cuylabs/agent-core/subagents  — local child-agent tools, profiles, discovery
+ *   @cuylabs/agent-core/plugin     — extension system, event bus, settings
+ *   @cuylabs/agent-core/team       — multi-agent coordination, task board, mailbox
+ */
+export * from "./agent/index.js";
+export * from "./intervention/index.js";
+export * from "./tool/index.js";
+export * from "./models/index.js";
+export * from "./mcp/index.js";
+export * from "./execution/index.js";
+export * from "./middleware/index.js";
+export * from "./prompt/index.js";
+export * from "./profiles/index.js";
+export * from "./tool/host/index.js";
+export * from "./sandbox/index.js";
+export * from "./execution/scope/index.js";
+export * from "./inference/index.js";
+export * from "./storage/index.js";
+export * from "./tracking/index.js";
+export * from "./context/index.js";
+export * from "./memory/index.js";
+export * from "./safety/index.js";
+export * from "./human/index.js";
+export * from "./inference/errors/index.js";
+export * from "./inference/retry.js";
+export * from "./skill/index.js";
+export * from "./dispatch/index.js";
+export { sleep } from "./utils/sleep.js";
+export * from "./subagents/index.js";
+export * from "./plugin/index.js";
+export * from "./events/index.js";
+export * from "./team/index.js";
+export * from "./logger/index.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,yBAAyB,CAAC;AAKxC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,uBAAuB,CAAC;AAKtC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAKpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,sBAAsB,CAAC;AAKrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAKlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,sBAAsB,CAAC;AAKrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAKlC,cAAc,kBAAkB,CAAC"}