@vinhnt-sdk/core 0.1.1 → 0.1.3

package/dist/index.js

@@ -1,77 +1,202 @@
 // @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";
-// === Event bus ===
-export { InMemoryEventBus } from "./event-bus/in-memory-bus.js";
-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";
-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";
+//
+// 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) ===
-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";
+/**
+ * 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";
 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 ===
+export { RunStateMachine } from "@vinhnt-sdk/step-executor";
+// === 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 "@vinhnt-sdk/event";
+// === Session management ===
+/**
+ * In-memory session state management.
+ */
+export { InMemorySessionState } from "@vinhnt-sdk/session";
+/**
+ * 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";
+// === 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";
+export { getTextContent } from "./model.js";
 // === Permission stores ===
-export { InMemoryApprovalStore } from "./permission/saved.js";
+/**
+ * In-memory approval store for managing permission approvals.
+ */
+export { InMemoryApprovalStore } from "@vinhnt-sdk/permission";
+// === 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";
+export { createDisposable } from "./plugin.js";
+/**
+ * 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 { ToolRegistry, LazyToolRegistry, ToolProviderRegistry, defineTool, toolToDefinition, zodSchemaToNestedJsonSchema, createCodingDomain, generateDiff, createReadFileTool, createWriteFileTool, createEditFileTool, createApplyPatchTool, createListDirectoryTool, createReadImageTool, readImageToContentParts, FileReadTracker, InMemoryFileHistory, createFileHistoryHook, createShellTool, ToolSandbox, signalToToolContext, createSandbox, createWebFetchTool, createWebSearchTool, TavilySearchProvider, SerperSearchProvider, createGitStatusTool, createGitDiffTool, createGitLogTool, createGitCommitTool, createGlobFilesTool, createGrepFilesTool, createToolSearchTool, createQuestionTool, createTodoWriteTool, AgentToolProvider, SkillToolProvider, ToolFileProvider, ToolFileLoader, } from "@vinhnt-sdk/tools";
+export { BuiltinToolProvider } from "./tool/builtin-provider.js";
+export { ToolRuntime } from "./tool/runtime.js";
+export { createKernelTools, createPluginToolHook } from "./tool/bridge.js";
+export { createToolProviderRegistry, createToolProvider, registerProviderTools } from "./tool/provider-helpers.js";
+// === 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

package/dist/index.js.map

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

package/dist/kernel/approval-handler.d.ts

@@ -13,5 +13,5 @@ export interface ApprovalHandlerDeps {
     readonly pluginManager: PluginManager | undefined;
     currentAgent: AgentConfig | undefined;
 }
-export declare function handleApproval(permResult: PermissionCheckResult, tc: ToolExecutionPlan, toolCtx: ToolContext, runId: RunId, ctx: RequestContext, _sessionId: string | undefined, messages: ChatMessage[], deps: ApprovalHandlerDeps): Promise<boolean>;
+export declare function handleApproval(permResult: PermissionCheckResult, tc: ToolExecutionPlan, toolCtx: ToolContext, runId: RunId, ctx: RequestContext, _sessionId: string | undefined, messages: ChatMessage[], deps: ApprovalHandlerDeps, selfApproving?: boolean): Promise<boolean>;
 //# sourceMappingURL=approval-handler.d.ts.map

package/dist/kernel/approval-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-handler.d.ts","sourceRoot":"","sources":["../../src/kernel/approval-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE;QAAE,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,oBAAoB,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACrI,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;CACvC;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,OAAO,CAAC,CA2BlB"}
+{"version":3,"file":"approval-handler.d.ts","sourceRoot":"","sources":["../../src/kernel/approval-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE;QAAE,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,oBAAoB,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACrI,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;CACvC;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,mBAAmB,EACzB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,OAAO,CAAC,CA+BlB"}

package/dist/kernel/approval-handler.js

@@ -1,7 +1,11 @@
 import { toolDomain } from "./kernel-utils.js";
-export async function handleApproval(permResult, tc, toolCtx, runId, ctx, _sessionId, messages, deps) {
+export async function handleApproval(permResult, tc, toolCtx, runId, ctx, _sessionId, messages, deps, selfApproving) {
     if (!permResult.needsApproval || permResult.allowed)
         return true;
+    // Single approval path: self-approving tools ask via their own `ctx.ask`
+    // (which persists savePatterns on "always"). Defer the gate-level ask.
+    if (selfApproving)
+        return true;
     const savedOk = deps.permissionGate.checkSavedApproval(tc.toolName, deps.currentAgent?.id);
     if (savedOk)
         return true;

package/dist/kernel/approval-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"approval-handler.js","sourceRoot":"","sources":["../../src/kernel/approval-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS/C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAiC,EACjC,EAAqB,EACrB,OAAoB,EACpB,KAAY,EACZ,GAAmB,EACnB,UAA8B,EAC9B,QAAuB,EACvB,IAAyB;IAEzB,IAAI,CAAC,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC3F,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9B,UAAU,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACjC,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,MAAM,EAAE,UAAU,CAAC,MAAO;KAC3B,CAAC,CAAC;IAEH,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YACzB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa;YACnD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO;YAC1D,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,QAAQ,oBAAoB,EAAE;SACvJ,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,QAAQ,oBAAoB,EAAE,CAAC,CAAC;QACjH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"approval-handler.js","sourceRoot":"","sources":["../../src/kernel/approval-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS/C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAiC,EACjC,EAAqB,EACrB,OAAoB,EACpB,KAAY,EACZ,GAAmB,EACnB,UAA8B,EAC9B,QAAuB,EACvB,IAAyB,EACzB,aAAuB;IAEvB,IAAI,CAAC,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEjE,yEAAyE;IACzE,uEAAuE;IACvE,IAAI,aAAa;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC3F,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9B,UAAU,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACjC,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,MAAM,EAAE,UAAU,CAAC,MAAO;KAC3B,CAAC,CAAC;IAEH,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YACzB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa;YACnD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO;YAC1D,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,QAAQ,oBAAoB,EAAE;SACvJ,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,QAAQ,oBAAoB,EAAE,CAAC,CAAC;QACjH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/kernel/circuit-breaker.d.ts

@@ -4,6 +4,12 @@ export interface CircuitBreakerOptions {
     successThreshold?: number;
     resetTimeoutMs?: number;
     isFailure?: (err: unknown) => boolean;
+    /** Maximum number of retries for transient failures. Default: 3 */
+    maxRetries?: number;
+    /** Base delay for exponential backoff in ms. Default: 1000 */
+    backoffMs?: number;
+    /** Maximum delay for backoff in ms. Default: 30000 */
+    maxBackoffMs?: number;
 }
 export declare class CircuitBreaker {
     private state;
@@ -13,10 +19,22 @@ export declare class CircuitBreaker {
     private readonly options;
     constructor(options?: CircuitBreakerOptions);
     getState(): CircuitState;
-    call<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute a function with circuit breaker and retry logic.
+     * Retries on transient failures with exponential backoff.
+     *
+     * @param fn - The async function to execute
+     * @param signal - Optional AbortSignal for cancellation
+     * @returns The result of the function
+     * @throws CircuitBreakerOpenError if circuit is open
+     * @throws The original error if all retries fail
+     */
+    call<T>(fn: () => Promise<T>, signal?: AbortSignal): Promise<T>;
     private onSuccess;
     private onFailure;
     reset(): void;
+    /** Get the current configuration options. */
+    getOptions(): Readonly<Required<CircuitBreakerOptions>>;
 }
 export declare class CircuitBreakerOpenError extends Error {
     readonly remainingMs: number;

package/dist/kernel/circuit-breaker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/kernel/circuit-breaker.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAeD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAE9C,OAAO,CAAC,EAAE,qBAAqB;IAI3C,QAAQ,IAAI,YAAY;IAQlB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB/C,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;IAcjB,KAAK,IAAI,IAAI;CAMd;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,cAAc,EAAE,MAAM;CAKnC"}
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/kernel/circuit-breaker.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACtC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAkBD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAE9C,OAAO,CAAC,EAAE,qBAAqB;IAO3C,QAAQ,IAAI,YAAY;IAQxB;;;;;;;;;OASG;IACG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAoDrE,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;IAcjB,KAAK,IAAI,IAAI;IAOb,6CAA6C;IAC7C,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CAGxD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,cAAc,EAAE,MAAM;CAKnC"}

package/dist/kernel/circuit-breaker.js

@@ -2,6 +2,9 @@ const DEFAULT_OPTIONS = {
     failureThreshold: 5,
     successThreshold: 2,
     resetTimeoutMs: 30_000,
+    maxRetries: 3,
+    backoffMs: 1000,
+    maxBackoffMs: 30_000,
     isFailure: (err) => {
         const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
         if (msg.includes("auth") || msg.includes("unauthorized") || msg.includes("invalid api key"))
@@ -20,7 +23,10 @@ export class CircuitBreaker {
     halfOpenSuccesses = 0;
     options;
     constructor(options) {
-        this.options = { ...DEFAULT_OPTIONS, ...options };
+        this.options = {
+            ...DEFAULT_OPTIONS,
+            ...Object.fromEntries(Object.entries(options ?? {}).filter(([, v]) => v !== undefined)),
+        };
     }
     getState() {
         if (this.state === "open" && Date.now() - this.lastFailureTime >= this.options.resetTimeoutMs) {
@@ -29,20 +35,54 @@ export class CircuitBreaker {
         }
         return this.state;
     }
-    async call(fn) {
+    /**
+     * Execute a function with circuit breaker and retry logic.
+     * Retries on transient failures with exponential backoff.
+     *
+     * @param fn - The async function to execute
+     * @param signal - Optional AbortSignal for cancellation
+     * @returns The result of the function
+     * @throws CircuitBreakerOpenError if circuit is open
+     * @throws The original error if all retries fail
+     */
+    async call(fn, signal) {
         const state = this.getState();
         if (state === "open") {
             throw new CircuitBreakerOpenError(this.options.resetTimeoutMs);
         }
-        try {
-            const result = await fn();
-            this.onSuccess();
-            return result;
-        }
-        catch (err) {
-            this.onFailure(err);
-            throw err;
+        let lastError;
+        let attempt = 0;
+        while (attempt <= this.options.maxRetries) {
+            if (signal?.aborted) {
+                throw new DOMException("Aborted", "AbortError");
+            }
+            try {
+                const result = await fn();
+                this.onSuccess();
+                return result;
+            }
+            catch (err) {
+                lastError = err;
+                // Check if error is retryable
+                if (!this.options.isFailure(err)) {
+                    throw err;
+                }
+                this.onFailure(err);
+                // Don't retry if we've hit the circuit breaker
+                if (this.getState() === "open") {
+                    throw new CircuitBreakerOpenError(this.options.resetTimeoutMs);
+                }
+                // Don't retry on last attempt
+                if (attempt >= this.options.maxRetries) {
+                    throw err;
+                }
+                // Calculate delay with exponential backoff
+                const delay = Math.min(this.options.backoffMs * Math.pow(2, attempt), this.options.maxBackoffMs);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                attempt++;
+            }
         }
+        throw lastError;
     }
     onSuccess() {
         if (this.state === "half_open") {
@@ -76,6 +116,10 @@ export class CircuitBreaker {
         this.lastFailureTime = 0;
         this.halfOpenSuccesses = 0;
     }
+    /** Get the current configuration options. */
+    getOptions() {
+        return this.options;
+    }
 }
 export class CircuitBreakerOpenError extends Error {
     remainingMs;

package/dist/kernel/circuit-breaker.js.map

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

package/dist/kernel/kernel-error.d.ts

@@ -1,7 +1,8 @@
 import { VntError } from "@vinhnt-sdk/schema";
 export type KernelErrorCode = "session_busy" | "cancelled" | "max_steps_exceeded" | "max_tokens_exceeded" | "tool_failed" | "model_failed" | "session_store_failed" | "internal_error" | "timeout" | "model_unavailable";
 export declare class KernelError extends VntError {
-    readonly code: KernelErrorCode;
-    constructor(code: KernelErrorCode, message: string, inner?: Error);
+    readonly code: string;
+    readonly retryable = false;
+    constructor(kernelCode: KernelErrorCode, message: string, cause?: unknown);
 }
 //# sourceMappingURL=kernel-error.d.ts.map

package/dist/kernel/kernel-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel-error.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,WAAW,GACX,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,cAAc,GACd,sBAAsB,GACtB,gBAAgB,GAChB,SAAS,GACT,mBAAmB,CAAC;AAExB,qBAAa,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAMlE"}
+{"version":3,"file":"kernel-error.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,WAAW,GACX,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,cAAc,GACd,sBAAsB,GACtB,gBAAgB,GAChB,SAAS,GACT,mBAAmB,CAAC;AAExB,qBAAa,WAAY,SAAQ,QAAQ;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,SAAS,SAAS;gBAEtB,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK1E"}

package/dist/kernel/kernel-error.js

@@ -1,12 +1,11 @@
 import { VntError } from "@vinhnt-sdk/schema";
 export class KernelError extends VntError {
     code;
-    constructor(code, message, inner) {
-        super(message);
-        this.code = code;
-        this.name = `KernelError.${code}`;
-        if (inner)
-            this.cause = inner;
+    retryable = false;
+    constructor(kernelCode, message, cause) {
+        super(message, { cause });
+        this.code = kernelCode;
+        this.name = `KernelError.${kernelCode}`;
     }
 }
 //# sourceMappingURL=kernel-error.js.map

package/dist/kernel/kernel-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"kernel-error.js","sourceRoot":"","sources":["../../src/kernel/kernel-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAc9C,MAAM,OAAO,WAAY,SAAQ,QAAQ;IAC9B,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe,EAAE,KAAa;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,eAAe,IAAI,EAAE,CAAC;QAClC,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"kernel-error.js","sourceRoot":"","sources":["../../src/kernel/kernel-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAc9C,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvB,IAAI,CAAS;IACb,SAAS,GAAG,KAAK,CAAC;IAElC,YAAY,UAA2B,EAAE,OAAe,EAAE,KAAe;QACvE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,eAAe,UAAU,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/kernel/kernel-session.d.ts

@@ -1,9 +1,9 @@
 import type { RequestContext, RunId, AgentConfig, KnownRunEvent } from "@vinhnt-sdk/schema";
-import type { RunEventStore, SessionStore } from "../session/store.js";
+import type { EventBus } from "@vinhnt-sdk/event";
+import type { RunEventStore, SessionStore } from "@vinhnt-sdk/session";
 import type { PluginManager } from "../plugin.js";
-import type { ModelCaller } from "./model-caller.js";
-import type { ToolSaga } from "./tool-saga.js";
-import type { EventBus } from "../event-bus/types.js";
+import type { ModelCaller } from "@vinhnt-sdk/llm";
+import type { ToolSaga } from "@vinhnt-sdk/tools";
 export interface KernelSessionDeps {
     store: RunEventStore;
     eventBus?: EventBus;
@@ -25,6 +25,14 @@ export declare function addSessionMessage(deps: KernelSessionDeps, sessionId: st
     cost?: number;
 }): Promise<void>;
 export declare function updateSessionOnComplete(deps: KernelSessionDeps, sessionId: string | undefined, runId: RunId, totalInputTokens: number, totalOutputTokens: number): Promise<void>;
-export declare function emitFail(deps: KernelSessionDeps, runId: RunId, ctx: RequestContext, reason: string, steps: number, sessionId?: string, totalInputTokens?: number, totalOutputTokens?: number, durationMs?: number): Promise<void>;
+/**
+ * Atomically persist a terminal run event (e.g. `run.completed`) together with
+ * the session terminal stats (model/tokens/cost) when the store supports
+ * {@link RunEventStore.appendTransactional}. When it does not, the session is
+ * updated BEFORE the event is emitted — closing the crash gap where a process
+ * dies between the two writes and terminal stats are lost.
+ */
+export declare function emitCompletedWithSession(deps: KernelSessionDeps, event: Omit<KnownRunEvent, "sequence">, sessionId: string | undefined, runId: RunId, totalInputTokens: number, totalOutputTokens: number, _status: string): Promise<void>;
+export declare function emitFail(deps: KernelSessionDeps, runId: RunId, ctx: RequestContext, reason: string, steps: number, sessionId?: string, totalInputTokens?: number, totalOutputTokens?: number, durationMs?: number, cancelled?: boolean): Promise<void>;
 export declare function buildAgentIdentity(agent: AgentConfig | undefined): string;
 //# sourceMappingURL=kernel-session.d.ts.map

package/dist/kernel/kernel-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel-session.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAEvH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD,wBAAsB,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9H;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7H,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,KAAK,EACZ,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,SAAI,EACpB,iBAAiB,SAAI,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAcf;AAOD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAqBzE"}
+{"version":3,"file":"kernel-session.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAY,MAAM,oBAAoB,CAAC;AAEtG,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD,wBAAsB,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB9H;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7H,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,KAAK,EACZ,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAWf;AA6BD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACtC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,KAAK,EACZ,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,SAAI,EACpB,iBAAiB,SAAI,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,UAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAOD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAqBzE"}