@vinhnt-sdk/core 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -1,115 +1,232 @@
-export type { BrandedId, RunId, SessionId, AgentId, ToolCallId, MessageId, TraceId, RequestId, WorkspaceId, EnvironmentId, FilePatchId, RunEvent, KnownRunEvent, RunStartedData, StepStartedData, TokenStreamedData, ThinkingStartedData, ThinkingContentData, ThinkingCompletedData, ContextCompressedData, TokenCountedData, ToolInvokedData, ToolCompletedData, ToolFailedData, ToolSelfCorrectingData, StepCompletedData, RunCompletedData, PermissionRequestedData, PermissionRepliedData, StepTypeChangedData, RequestContext, RunStatus, Session, Message, MessageTokens, SessionStats, AgentProfile, AgentCapabilities, AgentConfig, AgentPermissions, AgentMode, AgentBehaviourMode, AgentRule, AgentRuleset, PromptTier, PromptAssembly, CompressionSummary, MemoryEntry, SessionNode, SessionTreeSnapshot, TreeCursor, SessionTreeEvent, SessionTreeEventType, ApprovalRequest, ApprovalCategory, ApprovalStatus, ApprovalContext, ApprovalPolicy, PolicyEffect, AgentStepType, Result, SkillManifest, SkillDefinition, SkillSource, SkillSourceType, SkillMode, SkillPermission, SkillPermissionValue, } from "@vinhnt-sdk/schema";
-export { isAgentId, isRunId, isSessionId, isMessageId, isToolCallId, isTraceId, isRequestId, isRecord, assertAgentId, assertRunId, assertSessionId, assertMessageId, VntError, AgentNotFoundError, AgentValidationError, AgentPermissionDenied, ToolNotFoundError, ToolExecutionError, ToolPermissionDenied, RunNotFoundError, RunAbortedError, RunTimeoutError, APPROVAL_CATEGORY_LABELS, AGENT_STEP_LABELS, inferStepType, ok, fail, wildcardMatch, } from "@vinhnt-sdk/schema";
-export type { ToolRisk, ToolDefinition, ToolDefinitionLike } from "@vinhnt-sdk/tools";
-export type { JsonSchema7Object, JsonSchemaProperty } from "@vinhnt-sdk/tools";
-export type { ChatMessage, MessageContentPart, ModelRequest, ModelResponse, ModelStreamEvent, ModelProvider, ModelPricing, ModelRegistry, ModelCapabilities } from "./model.js";
-export type { Tool, ToolConfig } from "@vinhnt-sdk/tools";
-export type { ToolFilter } from "@vinhnt-sdk/tools";
-export type { ToolContext, PermissionReply } from "@vinhnt-sdk/tools";
-export type { ApprovalStore, PermissionStore } from "./permission/saved.js";
-export type { PermissionEffect, PermissionRule, PermissionRuleset, PermissionRequest } from "./permission/permission.js";
-export type { PluginManifest, PluginContext, Plugin, PluginManager, PluginHooks, HookResult, HookName, HookPayload, HookReturn } from "./plugin.js";
-export { defineTool, toolToDefinition, zodSchemaToNestedJsonSchema } from "@vinhnt-sdk/tools";
-export { lintToolDescription, lintToolDefinitions } from "@vinhnt-sdk/tools";
-export type { ToolDescriptionReport, ToolDescriptionIssue, DescriptionIssueCode } from "@vinhnt-sdk/tools";
-export { ToolRegistry } from "@vinhnt-sdk/tools";
-export type { ToolPermissionRule, ToolMaterialization } from "@vinhnt-sdk/tools";
-export { ToolProviderRegistry } from "@vinhnt-sdk/tools";
-export type { ToolProvider } from "@vinhnt-sdk/tools";
-export { validateInput, ToolInputError } from "@vinhnt-sdk/tools";
-export { ToolSandbox, signalToToolContext, createSandbox } from "@vinhnt-sdk/tools";
-export type { SandboxConfig, SandboxScope, ProcessSandbox, SandboxResult } from "@vinhnt-sdk/tools";
-export { ToolRuntime } from "./tool/runtime.js";
-export type { ToolExecutionResult, ToolRuntimeConfig, ToolHook } from "./tool/runtime.js";
-export { createKernelTools, createPluginToolHook } from "./tool/bridge.js";
-export { FileReadTracker } from "@vinhnt-sdk/tools";
-export { InMemoryFileHistory } from "@vinhnt-sdk/tools";
-export type { FileHistory, FileVersion, UndoEntry } from "@vinhnt-sdk/tools";
-export { createFileHistoryHook } from "@vinhnt-sdk/tools";
-export { generateDiff } from "@vinhnt-sdk/tools";
-export type { UnifiedDiff } from "@vinhnt-sdk/tools";
-export { readImageToContentParts, createReadImageTool } from "@vinhnt-sdk/tools";
-export { createReadFileTool, createWriteFileTool, createEditFileTool, createApplyPatchTool, createListDirectoryTool, createShellTool, createGitStatusTool, createGitDiffTool, createGitLogTool, createGitCommitTool, createGlobFilesTool, createGrepFilesTool, createWebFetchTool, createQuestionTool, createWebSearchTool, createTodoWriteTool } from "@vinhnt-sdk/tools";
-export { createCodingDomain } from "@vinhnt-sdk/tools";
-export type { DomainManifest } from "@vinhnt-sdk/tools";
-export type { QuestionInput, QuestionHandler } from "@vinhnt-sdk/tools";
-export type { ShellToolConfig } from "@vinhnt-sdk/tools";
+/**
+ * Core agent kernel for building AI coding agents.
+ *
+ * The kernel manages agent lifecycle, tool execution, permissions, and LLM interactions.
+ *
+ * @example
+ * ```typescript
+ * import { AgentKernel } from "@vinhnt-sdk/core";
+ *
+ * const kernel = new AgentKernel({
+ *   workspaceRoot: "/path/to/project",
+ *   maxConcurrent: 3,
+ * });
+ *
+ * await kernel.start();
+ * ```
+ */
+/**
+ * Main agent kernel class - manages agent lifecycle and execution.
+ *
+ * @example
+ * ```typescript
+ * const kernel = new AgentKernel({
+ *   workspaceRoot: "/path/to/project",
+ *   maxConcurrent: 3,
+ *   toolRegistry: myToolRegistry,
+ * });
+ *
+ * const run = await kernel.startRun({
+ *   agentId: "coder",
+ *   prompt: "Write a hello world program",
+ * });
+ * ```
+ */
+export { AgentKernel, KernelError } from "./kernel/kernel.js";
+/**
+ * Configuration for the agent kernel.
+ */
+export type { AgentKernelConfig, RunHandle, AgentRunHandle, AgentRunResult } from "./kernel/kernel-types.js";
+/**
+ * Factory function for creating agent configurations.
+ *
+ * @example
+ * ```typescript
+ * const agent = createAgent({
+ *   id: "coder",
+ *   name: "Coder Agent",
+ *   model: "gpt-4",
+ *   systemPrompt: "You are a helpful coding assistant.",
+ * });
+ * ```
+ */
+export { createAgent } from "./agent/agent-factory.js";
+/**
+ * Parameters for creating an agent.
+ */
+export type { CreateAgentParams } from "./agent/agent-factory.js";
+/**
+ * In-memory event bus for publishing and subscribing to events.
+ *
+ * @example
+ * ```typescript
+ * const bus = new InMemoryEventBus();
+ *
+ * bus.on("tool.executed", (event) => {
+ *   console.log("Tool executed:", event.toolId);
+ * });
+ *
+ * await bus.publish({
+ *   type: "tool.executed",
+ *   toolId: "read_file",
+ *   timestamp: Date.now(),
+ * });
+ * ```
+ */
 export { InMemoryEventBus } from "./event-bus/in-memory-bus.js";
+/**
+ * Event bus interface and types.
+ */
 export type { EventBus, EventHandler, Unsubscribe } from "./event-bus/types.js";
-export type { RunEventStore, RunEventListener, SessionStore, SessionUpdates, RunEventSnapshot } from "./session/store.js";
-export type { ConversationCompactor } from "./session/compaction.js";
-export type { SessionTree } from "./session/session-tree.js";
+/**
+ * In-memory session state management.
+ */
 export { InMemorySessionState } from "./session/in-memory-session-state.js";
-export { restoreRunFromStore, findActiveSessionIds } from "./session/durable-reload.js";
-export type { RestoredRun } from "./session/durable-reload.js";
-export { NullRunEventStore, NullSessionStore } from "./session/null-store.js";
-export { InMemorySessionTree } from "./session/session-tree.js";
-export { createDefaultSessionTitleGenerator } from "./session/title.js";
-export { SessionRunCoordinator, kernelAsRunHandler } from "./session/run-coordinator.js";
-export type { SessionEvent, SessionEventType } from "./session/run-coordinator.js";
-export type { SessionRuntimeState, SessionRuntimeSnapshot } from "./session/session-state.js";
-export type { AgentRegistry, SourceDir } from "./agent/agent-registry.js";
+/**
+ * Coordinates multiple runs within a session.
+ */
+export { SessionRunCoordinator } from "./session/run-coordinator.js";
+/**
+ * Session and run event store interfaces.
+ */
+export type { RunEventStore, SessionStore } from "./session/store.js";
+/**
+ * In-memory agent registry for managing agent configurations.
+ *
+ * @example
+ * ```typescript
+ * const registry = new InMemoryAgentRegistry();
+ * registry.register({
+ *   id: "coder",
+ *   name: "Coder Agent",
+ *   model: "gpt-4",
+ * });
+ *
+ * const agent = registry.get("coder");
+ * ```
+ */
 export { InMemoryAgentRegistry } from "./agent/agent-registry.js";
-export type { AgentDefinition, AgentDefParser } from "./agent/agent-def.js";
-export { AgentParser } from "./agent/agent-parser.js";
-export { createAgent, createSubAgent, validateAgentConfig } from "./agent/agent-factory.js";
-export type { CreateAgentParams, SubAgentParams } from "./agent/agent-factory.js";
-export { ExecutionEngine } from "./agent/execution-engine.js";
-export { createSpawnAgentTool } from "./agent/spawn-agent-tool.js";
-export type { SpawnAgentInput } from "./agent/spawn-agent-tool.js";
-export { createDelegateTool } from "./agent/delegate-tool.js";
-export type { DelegateInput } from "./agent/delegate-tool.js";
-export { createDelegateBatchTool } from "./agent/delegate-batch-tool.js";
-export type { DelegateBatchInput } from "./agent/delegate-batch-tool.js";
-export { createListAgentsTool } from "./agent/list-agents-tool.js";
-export { createCreateAgentTool } from "./agent/create-agent-tool.js";
-export type { CreateAgentInput } from "./agent/create-agent-tool.js";
-export type { SkillDefRegistry, SkillDefParser } from "./skill/skill-def-registry.js";
-export { SkillParser } from "./skill/skill-parser.js";
-export { InMemorySkillDefRegistry } from "./skill/skill-def-registry.js";
-export { createSkillTool, createSkillSearchTool } from "./skill/skill-tool.js";
-export type { SkillToolInput } from "./skill/skill-tool.js";
-export { createCreateSkillTool } from "./skill/create-skill-tool.js";
-export type { CreateSkillInput } from "./skill/create-skill-tool.js";
-export { checkRiskAllowed, resolveEffectivePermissions, mergeRulesets, normalizePermissions, evaluatePermission } from "./permission/checker.js";
-export type { PermissionResult } from "./permission/checker.js";
-export { matchPermission, buildPermissionRules } from "./permission/evaluator.js";
-export type { ContextSourceKey, ContextSourceValue, ContextSnapshot, SystemContext, ReconcileResult, ContextRegistry } from "./system-context/types.js";
-export { createContextRegistry } from "./system-context/registry.js";
-export { createDateSource } from "./system-context/sources/date-source.js";
-export { createWorkspaceSource } from "./system-context/sources/workspace-source.js";
-export type { WorkspaceInfo } from "./system-context/sources/workspace-source.js";
-export { createInstructionsSource } from "./system-context/sources/instructions-source.js";
-export type { InstructionsInfo } from "./system-context/sources/instructions-source.js";
-export { createAgentSource } from "./system-context/sources/agent-source.js";
-export type { AgentContextInfo } from "./system-context/sources/agent-source.js";
-export { createSystemPromptSource } from "./system-context/prompts/system-prompt-source.js";
-export { createSkillGuidanceSource } from "./system-context/sources/skill-guidance-source.js";
-export type { SkillGuidanceInfo } from "./system-context/sources/skill-guidance-source.js";
-export { InMemoryMemoryStore, SessionMemory, BoundedMemory, ContextCompressor, LlmCompactor, WriteApprovalQueue, BackgroundReview, LearningEngine, createMemorySearchTool, buildPrompt } from "@vinhnt-sdk/knowledge";
-export type { MemoryItem, MemoryStore, MemoryTier, Skill, CompressorOptions, ReviewOptions, PromptBuilderOptions } from "@vinhnt-sdk/knowledge";
-export { AgentKernel, KernelError, CircuitBreaker, CircuitBreakerOpenError } from "./kernel/kernel.js";
-export type { RunState, KernelErrorCode, CircuitState, CircuitBreakerOptions } from "./kernel/kernel.js";
-export type { AgentKernelConfig, RunHandle, KernelSandboxConfig, PermissionConfig, ModelRoutingConfig, HookConfig } from "./kernel/kernel-types.js";
-export { normalizeConfig } from "./kernel/kernel-types.js";
-export { RunStateMachine } from "./kernel/run-state.js";
-export { PermissionGate } from "./kernel/permission-gate.js";
-export type { PermissionCheckResult, ApprovalDecision, DynamicRule } from "./kernel/permission-gate.js";
-export { ModelCaller } from "./kernel/model-caller.js";
-export { evaluateStopConditions, toToolCallOutcome } from "./kernel/termination.js";
-export type { StopCondition, TerminationPolicy, ToolCallOutcome, StepVerificationContext } from "./kernel/termination.js";
-export { LifecycleManager, type LifecycleResource, type LifecycleManagerConfig } from "./kernel/lifecycle-manager.js";
-export { canTransitionRun, terminalRunStatuses } from "./kernel/state-machine.js";
-export { ToolSaga } from "./kernel/tool-saga.js";
-export { DefaultPluginManager } from "./plugin/manager.js";
-export { WorkspaceManager } from "./workspace.js";
-export type { Workspace, WorkspaceEventType, WorkspaceEvent } from "./workspace.js";
+/**
+ * Agent registry interface.
+ */
+export type { AgentRegistry } from "./agent/agent-registry.js";
+/**
+ * In-memory model registry for managing model providers.
+ *
+ * @example
+ * ```typescript
+ * const registry = new InMemoryModelRegistry();
+ * registry.register({
+ *   id: "openai",
+ *   name: "OpenAI",
+ *   baseUrl: "https://api.openai.com",
+ * });
+ * ```
+ */
 export { InMemoryModelRegistry } from "./model.js";
+/**
+ * Model provider interfaces and types.
+ */
+export type { ModelProvider, ModelRequest, ModelResponse, ModelStreamEvent } from "./model.js";
+/**
+ * In-memory approval store for managing permission approvals.
+ */
 export { InMemoryApprovalStore } from "./permission/saved.js";
+/**
+ * Approval store interface.
+ */
+export type { ApprovalStore } from "./permission/saved.js";
+/**
+ * Workspace manager for handling file operations and workspace context.
+ */
+export { WorkspaceManager } from "./workspace.js";
+/**
+ * In-memory skill definition registry.
+ */
+export { InMemorySkillDefRegistry } from "./skill/skill-def-registry.js";
+/**
+ * Request tracing for monitoring and debugging.
+ */
 export { Tracer } from "./tracer.js";
-export type { Traceable } from "./tracer.js";
+/**
+ * Set the global logger instance.
+ *
+ * @example
+ * ```typescript
+ * import { setLogger } from "@vinhnt-sdk/core";
+ *
+ * setLogger({
+ *   info: (msg, ...args) => console.log(msg, ...args),
+ *   warn: (msg, ...args) => console.warn(msg, ...args),
+ *   error: (msg, ...args) => console.error(msg, ...args),
+ *   debug: (msg, ...args) => console.debug(msg, ...args),
+ * });
+ * ```
+ */
 export { setLogger, setLogLevel, getLogger } from "./logger.js";
+/**
+ * Logger interface and log level types.
+ */
 export type { Logger, LogLevel } from "./logger.js";
-export { sanitizeForLLM, validateToolOutput, detectInjectionPatterns } from "@vinhnt-sdk/security";
-export { redactSecrets, detectSecrets, createRedactingLogger } from "@vinhnt-sdk/security";
+/**
+ * Plugin system interfaces and types.
+ */
+export type { PluginManifest, PluginContext, PluginHooks, Plugin } from "./plugin.js";
+/**
+ * System context types.
+ */
+export type { ContextSourceValue, ContextSourceKey } from "./system-context/types.js";
+/**
+ * Core type identifiers.
+ */
+export type { RunId, SessionId, AgentId, TraceId, RequestId, RunStatus, RequestContext, AgentConfig, AgentProfile, Session, Message, } from "@vinhnt-sdk/schema";
+/**
+ * Error classes for the SDK.
+ *
+ * All errors extend VntError and include error codes and retryable flags.
+ */
+export { VntError, AgentNotFoundError, AgentValidationError, AgentPermissionDenied, ToolNotFoundError, ToolExecutionError, ToolPermissionDenied, RunNotFoundError, RunAbortedError, RunTimeoutError, CircuitBreakerOpenError, ToolInputError, PermissionDeniedError, ValidationError, TimeoutError, NetworkError, RateLimitError, AuthenticationError, ConfigurationError, PluginError, } from "@vinhnt-sdk/schema";
+/**
+ * Error context type.
+ */
+export type { VntErrorCtx } from "@vinhnt-sdk/schema";
+/**
+ * Define a custom tool.
+ *
+ * @example
+ * ```typescript
+ * import { defineTool } from "@vinhnt-sdk/core";
+ * import { z } from "zod";
+ *
+ * const myTool = defineTool({
+ *   name: "my_tool",
+ *   description: "A custom tool",
+ *   risk: "read",
+ *   input: z.object({
+ *     query: z.string(),
+ *   }),
+ *   async execute(input, ctx) {
+ *     return `Result: ${input.query}`;
+ *   },
+ * });
+ * ```
+ */
+export { defineTool, ToolRegistry } from "@vinhnt-sdk/tools";
+/**
+ * Tool system types.
+ */
+export type { Tool, ToolConfig, ToolRisk, ToolDefinition } from "@vinhnt-sdk/tools";
+export type { ToolContext, ToolHook, ToolProvider } from "@vinhnt-sdk/tools";
+/**
+ * Bounded memory store with size limits.
+ */
+export { BoundedMemory, ContextCompressor } from "@vinhnt-sdk/knowledge";
+/**
+ * Memory system types.
+ */
+export type { MemoryItem, MemoryStore } from "@vinhnt-sdk/knowledge";
+/**
+ * Redact secrets from text.
+ */
+export { redactSecrets, detectSecrets } from "@vinhnt-sdk/security";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,77 +1,194 @@
 // @vinhnt-sdk/core
 // Core agent engine for building AI coding agents
-export { isAgentId, isRunId, isSessionId, isMessageId, isToolCallId, isTraceId, isRequestId, isRecord, assertAgentId, assertRunId, assertSessionId, assertMessageId, VntError, AgentNotFoundError, AgentValidationError, AgentPermissionDenied, ToolNotFoundError, ToolExecutionError, ToolPermissionDenied, RunNotFoundError, RunAbortedError, RunTimeoutError, APPROVAL_CATEGORY_LABELS, AGENT_STEP_LABELS, inferStepType, ok, fail, wildcardMatch, } from "@vinhnt-sdk/schema";
-// === Tool system ===
-export { defineTool, toolToDefinition, zodSchemaToNestedJsonSchema } from "@vinhnt-sdk/tools";
-export { lintToolDescription, lintToolDefinitions } from "@vinhnt-sdk/tools";
-export { ToolRegistry } from "@vinhnt-sdk/tools";
-export { ToolProviderRegistry } from "@vinhnt-sdk/tools";
-export { validateInput, ToolInputError } from "@vinhnt-sdk/tools";
-export { ToolSandbox, signalToToolContext, createSandbox } from "@vinhnt-sdk/tools";
-export { ToolRuntime } from "./tool/runtime.js";
-export { createKernelTools, createPluginToolHook } from "./tool/bridge.js";
-export { FileReadTracker } from "@vinhnt-sdk/tools";
-export { InMemoryFileHistory } from "@vinhnt-sdk/tools";
-export { createFileHistoryHook } from "@vinhnt-sdk/tools";
-export { generateDiff } from "@vinhnt-sdk/tools";
-export { readImageToContentParts, createReadImageTool } from "@vinhnt-sdk/tools";
-export { createReadFileTool, createWriteFileTool, createEditFileTool, createApplyPatchTool, createListDirectoryTool, createShellTool, createGitStatusTool, createGitDiffTool, createGitLogTool, createGitCommitTool, createGlobFilesTool, createGrepFilesTool, createWebFetchTool, createQuestionTool, createWebSearchTool, createTodoWriteTool } from "@vinhnt-sdk/tools";
-export { createCodingDomain } from "@vinhnt-sdk/tools";
+//
+// PUBLIC API - Only essential exports for users
+// Internal implementation details are NOT exported here
+/**
+ * Core agent kernel for building AI coding agents.
+ *
+ * The kernel manages agent lifecycle, tool execution, permissions, and LLM interactions.
+ *
+ * @example
+ * ```typescript
+ * import { AgentKernel } from "@vinhnt-sdk/core";
+ *
+ * const kernel = new AgentKernel({
+ *   workspaceRoot: "/path/to/project",
+ *   maxConcurrent: 3,
+ * });
+ *
+ * await kernel.start();
+ * ```
+ */
+// === Kernel (core runtime) ===
+/**
+ * Main agent kernel class - manages agent lifecycle and execution.
+ *
+ * @example
+ * ```typescript
+ * const kernel = new AgentKernel({
+ *   workspaceRoot: "/path/to/project",
+ *   maxConcurrent: 3,
+ *   toolRegistry: myToolRegistry,
+ * });
+ *
+ * const run = await kernel.startRun({
+ *   agentId: "coder",
+ *   prompt: "Write a hello world program",
+ * });
+ * ```
+ */
+export { AgentKernel, KernelError } from "./kernel/kernel.js";
+// === Agent system ===
+/**
+ * Factory function for creating agent configurations.
+ *
+ * @example
+ * ```typescript
+ * const agent = createAgent({
+ *   id: "coder",
+ *   name: "Coder Agent",
+ *   model: "gpt-4",
+ *   systemPrompt: "You are a helpful coding assistant.",
+ * });
+ * ```
+ */
+export { createAgent } from "./agent/agent-factory.js";
 // === Event bus ===
+/**
+ * In-memory event bus for publishing and subscribing to events.
+ *
+ * @example
+ * ```typescript
+ * const bus = new InMemoryEventBus();
+ *
+ * bus.on("tool.executed", (event) => {
+ *   console.log("Tool executed:", event.toolId);
+ * });
+ *
+ * await bus.publish({
+ *   type: "tool.executed",
+ *   toolId: "read_file",
+ *   timestamp: Date.now(),
+ * });
+ * ```
+ */
 export { InMemoryEventBus } from "./event-bus/in-memory-bus.js";
+// === Session management ===
+/**
+ * In-memory session state management.
+ */
 export { InMemorySessionState } from "./session/in-memory-session-state.js";
-export { restoreRunFromStore, findActiveSessionIds } from "./session/durable-reload.js";
-export { NullRunEventStore, NullSessionStore } from "./session/null-store.js";
-export { InMemorySessionTree } from "./session/session-tree.js";
-export { createDefaultSessionTitleGenerator } from "./session/title.js";
-export { SessionRunCoordinator, kernelAsRunHandler } from "./session/run-coordinator.js";
+/**
+ * Coordinates multiple runs within a session.
+ */
+export { SessionRunCoordinator } from "./session/run-coordinator.js";
+// === Agent registry ===
+/**
+ * In-memory agent registry for managing agent configurations.
+ *
+ * @example
+ * ```typescript
+ * const registry = new InMemoryAgentRegistry();
+ * registry.register({
+ *   id: "coder",
+ *   name: "Coder Agent",
+ *   model: "gpt-4",
+ * });
+ *
+ * const agent = registry.get("coder");
+ * ```
+ */
 export { InMemoryAgentRegistry } from "./agent/agent-registry.js";
-export { AgentParser } from "./agent/agent-parser.js";
-export { createAgent, createSubAgent, validateAgentConfig } from "./agent/agent-factory.js";
-export { ExecutionEngine } from "./agent/execution-engine.js";
-export { createSpawnAgentTool } from "./agent/spawn-agent-tool.js";
-export { createDelegateTool } from "./agent/delegate-tool.js";
-export { createDelegateBatchTool } from "./agent/delegate-batch-tool.js";
-export { createListAgentsTool } from "./agent/list-agents-tool.js";
-export { createCreateAgentTool } from "./agent/create-agent-tool.js";
-export { SkillParser } from "./skill/skill-parser.js";
-export { InMemorySkillDefRegistry } from "./skill/skill-def-registry.js";
-export { createSkillTool, createSkillSearchTool } from "./skill/skill-tool.js";
-export { createCreateSkillTool } from "./skill/create-skill-tool.js";
-// === Permission system ===
-export { checkRiskAllowed, resolveEffectivePermissions, mergeRulesets, normalizePermissions, evaluatePermission } from "./permission/checker.js";
-export { matchPermission, buildPermissionRules } from "./permission/evaluator.js";
-export { createContextRegistry } from "./system-context/registry.js";
-export { createDateSource } from "./system-context/sources/date-source.js";
-export { createWorkspaceSource } from "./system-context/sources/workspace-source.js";
-export { createInstructionsSource } from "./system-context/sources/instructions-source.js";
-export { createAgentSource } from "./system-context/sources/agent-source.js";
-export { createSystemPromptSource } from "./system-context/prompts/system-prompt-source.js";
-export { createSkillGuidanceSource } from "./system-context/sources/skill-guidance-source.js";
-// === Knowledge system ===
-export { InMemoryMemoryStore, SessionMemory, BoundedMemory, ContextCompressor, LlmCompactor, WriteApprovalQueue, BackgroundReview, LearningEngine, createMemorySearchTool, buildPrompt } from "@vinhnt-sdk/knowledge";
-// === Kernel (core runtime) ===
-export { AgentKernel, KernelError, CircuitBreaker, CircuitBreakerOpenError } from "./kernel/kernel.js";
-export { normalizeConfig } from "./kernel/kernel-types.js";
-export { RunStateMachine } from "./kernel/run-state.js";
-export { PermissionGate } from "./kernel/permission-gate.js";
-export { ModelCaller } from "./kernel/model-caller.js";
-export { evaluateStopConditions, toToolCallOutcome } from "./kernel/termination.js";
-export { LifecycleManager } from "./kernel/lifecycle-manager.js";
-export { canTransitionRun, terminalRunStatuses } from "./kernel/state-machine.js";
-export { ToolSaga } from "./kernel/tool-saga.js";
-export { DefaultPluginManager } from "./plugin/manager.js";
-// === Workspace ===
-export { WorkspaceManager } from "./workspace.js";
-// === Model ===
+// === Model registry ===
+/**
+ * In-memory model registry for managing model providers.
+ *
+ * @example
+ * ```typescript
+ * const registry = new InMemoryModelRegistry();
+ * registry.register({
+ *   id: "openai",
+ *   name: "OpenAI",
+ *   baseUrl: "https://api.openai.com",
+ * });
+ * ```
+ */
 export { InMemoryModelRegistry } from "./model.js";
 // === Permission stores ===
+/**
+ * In-memory approval store for managing permission approvals.
+ */
 export { InMemoryApprovalStore } from "./permission/saved.js";
+// === Workspace ===
+/**
+ * Workspace manager for handling file operations and workspace context.
+ */
+export { WorkspaceManager } from "./workspace.js";
+// === Skill system ===
+/**
+ * In-memory skill definition registry.
+ */
+export { InMemorySkillDefRegistry } from "./skill/skill-def-registry.js";
 // === Tracing ===
+/**
+ * Request tracing for monitoring and debugging.
+ */
 export { Tracer } from "./tracer.js";
 // === Logger ===
+/**
+ * Set the global logger instance.
+ *
+ * @example
+ * ```typescript
+ * import { setLogger } from "@vinhnt-sdk/core";
+ *
+ * setLogger({
+ *   info: (msg, ...args) => console.log(msg, ...args),
+ *   warn: (msg, ...args) => console.warn(msg, ...args),
+ *   error: (msg, ...args) => console.error(msg, ...args),
+ *   debug: (msg, ...args) => console.debug(msg, ...args),
+ * });
+ * ```
+ */
 export { setLogger, setLogLevel, getLogger } from "./logger.js";
-// === Security ===
-export { sanitizeForLLM, validateToolOutput, detectInjectionPatterns } from "@vinhnt-sdk/security";
-export { redactSecrets, detectSecrets, createRedactingLogger } from "@vinhnt-sdk/security";
+/**
+ * Error classes for the SDK.
+ *
+ * All errors extend VntError and include error codes and retryable flags.
+ */
+export { VntError, AgentNotFoundError, AgentValidationError, AgentPermissionDenied, ToolNotFoundError, ToolExecutionError, ToolPermissionDenied, RunNotFoundError, RunAbortedError, RunTimeoutError, CircuitBreakerOpenError, ToolInputError, PermissionDeniedError, ValidationError, TimeoutError, NetworkError, RateLimitError, AuthenticationError, ConfigurationError, PluginError, } from "@vinhnt-sdk/schema";
+// === Re-export essential types from tools ===
+/**
+ * Define a custom tool.
+ *
+ * @example
+ * ```typescript
+ * import { defineTool } from "@vinhnt-sdk/core";
+ * import { z } from "zod";
+ *
+ * const myTool = defineTool({
+ *   name: "my_tool",
+ *   description: "A custom tool",
+ *   risk: "read",
+ *   input: z.object({
+ *     query: z.string(),
+ *   }),
+ *   async execute(input, ctx) {
+ *     return `Result: ${input.query}`;
+ *   },
+ * });
+ * ```
+ */
+export { defineTool, ToolRegistry } from "@vinhnt-sdk/tools";
+// === Re-export essential types from knowledge ===
+/**
+ * Bounded memory store with size limits.
+ */
+export { BoundedMemory, ContextCompressor } from "@vinhnt-sdk/knowledge";
+// === Re-export essential types from security ===
+/**
+ * Redact secrets from text.
+ */
+export { redactSecrets, detectSecrets } from "@vinhnt-sdk/security";
 //# sourceMappingURL=index.js.map