kagent-ts 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -1,45 +1,89 @@
 export { Agent } from "./core/agent";
-export type { AgentConfig } from "./core/agent";
+export type { AgentConfig, ApprovalCallback } from "./core/agent";
 export { ReActAgent } from "./core/react-agent";
 export type { ReActAgentConfig } from "./core/react-agent";
 export { PlanSolveAgent } from "./core/plan-solve-agent";
 export type { PlanSolveAgentConfig } from "./core/plan-solve-agent";
+export { FusionAgent } from "./core/fusion-agent";
+export type { FusionAgentConfig, PlanConfirmCallback } from "./core/fusion-agent";
+export { OrchestratorAgent } from "./orchestrator/orchestrator-agent";
+export type { OrchestratorAgentConfig } from "./orchestrator/orchestrator-agent";
 export type { Tool } from "./core/types";
 export type { AgentHooks } from "./core/hooks";
-export { parseReActResponse, STRUCTURED_OUTPUT_INSTRUCTIONS, parsePlanSolveResponse, PLAN_SOLVE_INSTRUCTIONS, } from "./core/response-schema";
-export type { ReActResponse, ReActReasoning, ReActFinalAnswer, PlanSolveResponse, } from "./core/response-schema";
+export { parseReActResponse, STRUCTURED_OUTPUT_INSTRUCTIONS, parsePlanSolveResponse, PLAN_SOLVE_INSTRUCTIONS, parseFusionRouteResponse, parseFusionResponse, FUSION_ROUTE_INSTRUCTIONS, FUSION_EXECUTION_INSTRUCTIONS, INLINE_REFLECTION_PROMPT, } from "./core/response-schema";
+export type { ReActResponse, ReActReasoning, ReActFinalAnswer, PlanSolveResponse, FusionRouteResponse, FusionResponse, } from "./core/response-schema";
+export { parseDecomposeResponse, parseSynthesizeResponse, parseAdaptResponse, buildDecomposePrompt, buildSynthesizePrompt, buildAdaptPrompt, } from "./orchestrator/orchestrator-response";
+export type { TaskNode, TaskNodeStatus, TaskGraph, OrchestrationPlan, SynthesisResult, AdaptResult, OrchestratorSessionState, } from "./orchestrator/orchestrator-types";
 export { ToolRegistry } from "./tools/tool-registry";
 export { CircuitBreaker } from "./tools/circuit-breaker";
 export type { CircuitBreakerConfig } from "./tools/circuit-breaker";
-export { BreakerState } from "./tools/types";
-export type { BreakerStatus } from "./tools/types";
+export { BreakerState, ToolErrorCode } from "./tools/types";
+export type { BreakerStatus, ToolResult } from "./tools/types";
+export { toolSuccess, toolError } from "./tools/types";
+export { validateToolArgs } from "./tools/tool-validator";
+export { ToolOutputTruncator } from "./tools/tool-output-truncator";
+export type { ToolFilter } from "./tools/tool-filter";
+export { allowlist, denylist, pattern, all, any, filterTools, } from "./tools/tool-filter";
 export { ToolErrorTracker, categorizeError } from "./tools/error-tracker";
-export type { ErrorTrackerConfig } from "./tools/error-tracker";
-export type { ToolErrorTrace, TraceEvent, ErrorTraceSummary } from "./tools/types";
-export { BUILTIN_TOOLS, registerAllBuiltinTools, ReadFileTool, WriteFileTool, EditFileTool, GrepSearchTool, GlobSearchTool, } from "./tools/builtin/index";
-export { SkillManager, FileSkillLoader, parseFrontmatter, parseKeywords } from "./skills/index";
+export type { ToolErrorTrace, TraceEvent, ErrorTraceSummary, } from "./tools/types";
+export { BUILTIN_TOOLS, BUILTIN_TOOL_NAMES, registerAllBuiltinTools, ReadFileTool, WriteFileTool, EditFileTool, GrepSearchTool, GlobSearchTool, createListSubagentsTool, createSpawnSubagentTool, createListErrorsTool, createSkillTool, createRememberTool, createRecallTool, } from "./tools/builtin/index";
+export { SkillManager, FileSkillLoader, parseFrontmatter, } from "./skills/index";
 export type { Skill, SkillStatus } from "./skills/types";
 export { Message } from "./messages/message";
 export { Role } from "./messages/types";
 export type { MessageData, ToolCall } from "./messages/types";
 export type { LLMProvider, LLMResponse } from "./llm/interface";
-export { OpenAIProvider, LLMNetworkError, isNetworkError } from "./llm/openai-provider";
-export type { OpenAIConfig, OpenAIRetryConfig, NetworkErrorCause } from "./llm/openai-provider";
+export { LLMResponseErrorCode } from "./llm/interface";
+export { TokenBudget } from "./llm/token-budget";
+export type { TokenBudgetConfig, TokenBudgetStatus, TokenBudgetCost } from "./llm/token-budget";
+export { LLMNetworkError } from "./llm/errors";
+export type { NetworkErrorCause, RetryConfig } from "./llm/errors";
+export { OpenAIProvider, isNetworkError } from "./llm/openai-provider";
+export type { OpenAIConfig, OpenAIRetryConfig } from "./llm/openai-provider";
+export { AnthropicProvider } from "./llm/anthropic-provider";
+export type { AnthropicConfig } from "./llm/anthropic-provider";
+export { createLLMProvider } from "./llm/factory";
+export type { LLMProviderConfig, ProviderType } from "./llm/factory";
+export { FallbackProvider } from "./llm/fallback-provider";
+export type { FallbackProviderConfig } from "./llm/fallback-provider";
+export { RateLimitedProvider } from "./llm/rate-limiter";
+export type { RateLimitedProviderConfig } from "./llm/rate-limiter";
+export { ModelRouter } from "./llm/model-router";
+export type { ModelRouterConfig, ModelRoute } from "./llm/model-router";
 export { ContextManager } from "./context/context-manager";
 export type { ContextConfig, ContextState } from "./context/types";
-export type { CompressionStrategy, CompressionResult } from "./compression/interface";
-export { SlidingWindowCompression } from "./compression/sliding-window";
+export { ProgressiveCompressor } from "./compression/progressive-compressor";
+export type { CompressionStrategy, CompressionResult, } from "./compression/interface";
 export type { CompressionConfig } from "./compression/types";
 export { PreferenceManager } from "./preferences/preference-manager";
 export type { Preferences, PreferenceManagerConfig } from "./preferences/types";
 export { SessionManager } from "./session/session-manager";
 export type { SessionManagerConfig } from "./session/session-manager";
-export type { SessionState, SessionStatus, AgentType, PlanSolveSessionState, } from "./session/session-types";
+export type { SessionState, SessionStatus, AgentType, PlanSolveSessionState, FusionSessionState, } from "./session/session-types";
 export { countTokens, countMessageTokens } from "./utils/token-counter";
 export { TraceLogger } from "./trace/trace-logger";
 export type { TraceLoggerConfig } from "./trace/trace-logger";
 export type { AgentTraceEvent, AgentTraceEventType } from "./trace/types";
+export { SubAgentManager, SubAgentLoader } from "./subagent/index";
+export type { SubAgentDefinition, SubAgentResult } from "./subagent/index";
+export { RAGManager, OpenAIEmbeddingProvider, InMemoryVectorStore, ChromaVectorStore, InMemoryKeywordIndex, LLMReRanker, rrfFusion, chunkKey } from "./rag/index";
+export type { EmbeddingProvider, VectorStore, RAGDocument, RAGChunk, RAGSearchResult, RAGConfig, OpenAIEmbeddingConfig, ChromaVectorStoreConfig, BM25Result, RankedResult, RRFFusionResult, ReRanker, LLMReRankerConfig, } from "./rag/index";
 export { McpClientManager } from "./mcp/mcp-client-manager";
 export { McpConnectionError } from "./mcp/mcp-types";
 export type { McpServerConfig, McpConnectionStatus, McpConnectionErrorReport, } from "./mcp/mcp-types";
+export { ProjectRules } from "./rules/project-rules";
+export { wrapUntrusted, detectInjectionSignatures, buildInjectionWarning, wrapUserAuthored, buildUserContentInjectionWarning, wrapAndScan, } from "./security/index";
+export { Logger, ConsoleLogger, SilentLogger } from "./logging/index";
+export { MemoryManager } from "./memory/index";
+export type { Memory, MemoryType } from "./memory/index";
+export { ErrorNotebook } from "./reflection/error-notebook";
+export type { ErrorNotebookEntry, ErrorNotebookConfig, ReflectionErrorCategory, } from "./reflection/error-notebook";
+export { ReflectionAgent } from "./reflection/reflection-agent";
+export type { ReflectionAgentConfig, ReflectionInput, ReflectionFinding, } from "./reflection/reflection-agent";
+export { MemoryReflector } from "./reflection/memory-reflector";
+export type { MemoryReflectorConfig, MemoryReflectionInput, ExtractedMemory, } from "./reflection/memory-reflector";
+export { createReflectionHook } from "./reflection/reflection-hook";
+export type { ReflectionHookConfig } from "./reflection/reflection-hook";
+export { ToolCallEvaluator, EvalRunner, Benchmark } from "./eval";
+export type { ToolCallRecord, ToolCallStats, ToolCallScorecard, EvalCase, EvalResult, LLMEvalJudgment, EvalRunnerConfig, AgentFactory, BenchmarkConfig, Regression, Improvement, BenchmarkSummary, BenchmarkResult, } from "./eval";
 //# 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,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.McpConnectionError = exports.McpClientManager = exports.TraceLogger = exports.countMessageTokens = exports.countTokens = exports.SessionManager = exports.PreferenceManager = exports.SlidingWindowCompression = exports.ContextManager = exports.isNetworkError = exports.LLMNetworkError = exports.OpenAIProvider = exports.Role = exports.Message = exports.parseKeywords = exports.parseFrontmatter = exports.FileSkillLoader = exports.SkillManager = exports.GlobSearchTool = exports.GrepSearchTool = exports.EditFileTool = exports.WriteFileTool = exports.ReadFileTool = exports.registerAllBuiltinTools = exports.BUILTIN_TOOLS = exports.categorizeError = exports.ToolErrorTracker = exports.BreakerState = exports.CircuitBreaker = exports.ToolRegistry = exports.PLAN_SOLVE_INSTRUCTIONS = exports.parsePlanSolveResponse = exports.STRUCTURED_OUTPUT_INSTRUCTIONS = exports.parseReActResponse = exports.PlanSolveAgent = exports.ReActAgent = exports.Agent = void 0;
+exports.createRecallTool = exports.createRememberTool = exports.createSkillTool = exports.createListErrorsTool = exports.createSpawnSubagentTool = exports.createListSubagentsTool = exports.GlobSearchTool = exports.GrepSearchTool = exports.EditFileTool = exports.WriteFileTool = exports.ReadFileTool = exports.registerAllBuiltinTools = exports.BUILTIN_TOOL_NAMES = exports.BUILTIN_TOOLS = exports.categorizeError = exports.ToolErrorTracker = exports.filterTools = exports.any = exports.all = exports.pattern = exports.denylist = exports.allowlist = exports.ToolOutputTruncator = exports.validateToolArgs = exports.toolError = exports.toolSuccess = exports.ToolErrorCode = exports.BreakerState = exports.CircuitBreaker = exports.ToolRegistry = exports.buildAdaptPrompt = exports.buildSynthesizePrompt = exports.buildDecomposePrompt = exports.parseAdaptResponse = exports.parseSynthesizeResponse = exports.parseDecomposeResponse = exports.INLINE_REFLECTION_PROMPT = exports.FUSION_EXECUTION_INSTRUCTIONS = exports.FUSION_ROUTE_INSTRUCTIONS = exports.parseFusionResponse = exports.parseFusionRouteResponse = exports.PLAN_SOLVE_INSTRUCTIONS = exports.parsePlanSolveResponse = exports.STRUCTURED_OUTPUT_INSTRUCTIONS = exports.parseReActResponse = exports.OrchestratorAgent = exports.FusionAgent = exports.PlanSolveAgent = exports.ReActAgent = exports.Agent = void 0;
+exports.EvalRunner = exports.ToolCallEvaluator = exports.createReflectionHook = exports.MemoryReflector = exports.ReflectionAgent = exports.ErrorNotebook = exports.MemoryManager = exports.SilentLogger = exports.ConsoleLogger = exports.wrapAndScan = exports.buildUserContentInjectionWarning = exports.wrapUserAuthored = exports.buildInjectionWarning = exports.detectInjectionSignatures = exports.wrapUntrusted = exports.ProjectRules = exports.McpConnectionError = exports.McpClientManager = exports.chunkKey = exports.rrfFusion = exports.LLMReRanker = exports.InMemoryKeywordIndex = exports.ChromaVectorStore = exports.InMemoryVectorStore = exports.OpenAIEmbeddingProvider = exports.RAGManager = exports.SubAgentLoader = exports.SubAgentManager = exports.TraceLogger = exports.countMessageTokens = exports.countTokens = exports.SessionManager = exports.PreferenceManager = exports.ProgressiveCompressor = exports.ContextManager = exports.ModelRouter = exports.RateLimitedProvider = exports.FallbackProvider = exports.createLLMProvider = exports.AnthropicProvider = exports.isNetworkError = exports.OpenAIProvider = exports.LLMNetworkError = exports.TokenBudget = exports.LLMResponseErrorCode = exports.Role = exports.Message = exports.parseFrontmatter = exports.FileSkillLoader = exports.SkillManager = void 0;
+exports.Benchmark = void 0;
 // Core Agent
 var agent_1 = require("./core/agent");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
@@ -8,12 +10,29 @@ var react_agent_1 = require("./core/react-agent");
 Object.defineProperty(exports, "ReActAgent", { enumerable: true, get: function () { return react_agent_1.ReActAgent; } });
 var plan_solve_agent_1 = require("./core/plan-solve-agent");
 Object.defineProperty(exports, "PlanSolveAgent", { enumerable: true, get: function () { return plan_solve_agent_1.PlanSolveAgent; } });
+var fusion_agent_1 = require("./core/fusion-agent");
+Object.defineProperty(exports, "FusionAgent", { enumerable: true, get: function () { return fusion_agent_1.FusionAgent; } });
+var orchestrator_agent_1 = require("./orchestrator/orchestrator-agent");
+Object.defineProperty(exports, "OrchestratorAgent", { enumerable: true, get: function () { return orchestrator_agent_1.OrchestratorAgent; } });
 // Response schema — structured JSON output from LLM
 var response_schema_1 = require("./core/response-schema");
 Object.defineProperty(exports, "parseReActResponse", { enumerable: true, get: function () { return response_schema_1.parseReActResponse; } });
 Object.defineProperty(exports, "STRUCTURED_OUTPUT_INSTRUCTIONS", { enumerable: true, get: function () { return response_schema_1.STRUCTURED_OUTPUT_INSTRUCTIONS; } });
 Object.defineProperty(exports, "parsePlanSolveResponse", { enumerable: true, get: function () { return response_schema_1.parsePlanSolveResponse; } });
 Object.defineProperty(exports, "PLAN_SOLVE_INSTRUCTIONS", { enumerable: true, get: function () { return response_schema_1.PLAN_SOLVE_INSTRUCTIONS; } });
+Object.defineProperty(exports, "parseFusionRouteResponse", { enumerable: true, get: function () { return response_schema_1.parseFusionRouteResponse; } });
+Object.defineProperty(exports, "parseFusionResponse", { enumerable: true, get: function () { return response_schema_1.parseFusionResponse; } });
+Object.defineProperty(exports, "FUSION_ROUTE_INSTRUCTIONS", { enumerable: true, get: function () { return response_schema_1.FUSION_ROUTE_INSTRUCTIONS; } });
+Object.defineProperty(exports, "FUSION_EXECUTION_INSTRUCTIONS", { enumerable: true, get: function () { return response_schema_1.FUSION_EXECUTION_INSTRUCTIONS; } });
+Object.defineProperty(exports, "INLINE_REFLECTION_PROMPT", { enumerable: true, get: function () { return response_schema_1.INLINE_REFLECTION_PROMPT; } });
+// Orchestrator — structured decomposition, dispatch, synthesis, adapt
+var orchestrator_response_1 = require("./orchestrator/orchestrator-response");
+Object.defineProperty(exports, "parseDecomposeResponse", { enumerable: true, get: function () { return orchestrator_response_1.parseDecomposeResponse; } });
+Object.defineProperty(exports, "parseSynthesizeResponse", { enumerable: true, get: function () { return orchestrator_response_1.parseSynthesizeResponse; } });
+Object.defineProperty(exports, "parseAdaptResponse", { enumerable: true, get: function () { return orchestrator_response_1.parseAdaptResponse; } });
+Object.defineProperty(exports, "buildDecomposePrompt", { enumerable: true, get: function () { return orchestrator_response_1.buildDecomposePrompt; } });
+Object.defineProperty(exports, "buildSynthesizePrompt", { enumerable: true, get: function () { return orchestrator_response_1.buildSynthesizePrompt; } });
+Object.defineProperty(exports, "buildAdaptPrompt", { enumerable: true, get: function () { return orchestrator_response_1.buildAdaptPrompt; } });
 // Tools — circuit breaker & registry
 var tool_registry_1 = require("./tools/tool-registry");
 Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return tool_registry_1.ToolRegistry; } });
@@ -21,39 +40,82 @@ var circuit_breaker_1 = require("./tools/circuit-breaker");
 Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.CircuitBreaker; } });
 var types_1 = require("./tools/types");
 Object.defineProperty(exports, "BreakerState", { enumerable: true, get: function () { return types_1.BreakerState; } });
-// Tool error tracker — observability for tool failure chains
+Object.defineProperty(exports, "ToolErrorCode", { enumerable: true, get: function () { return types_1.ToolErrorCode; } });
+var types_2 = require("./tools/types");
+Object.defineProperty(exports, "toolSuccess", { enumerable: true, get: function () { return types_2.toolSuccess; } });
+Object.defineProperty(exports, "toolError", { enumerable: true, get: function () { return types_2.toolError; } });
+var tool_validator_1 = require("./tools/tool-validator");
+Object.defineProperty(exports, "validateToolArgs", { enumerable: true, get: function () { return tool_validator_1.validateToolArgs; } });
+// Tool output truncator — large output to disk
+var tool_output_truncator_1 = require("./tools/tool-output-truncator");
+Object.defineProperty(exports, "ToolOutputTruncator", { enumerable: true, get: function () { return tool_output_truncator_1.ToolOutputTruncator; } });
+var tool_filter_1 = require("./tools/tool-filter");
+Object.defineProperty(exports, "allowlist", { enumerable: true, get: function () { return tool_filter_1.allowlist; } });
+Object.defineProperty(exports, "denylist", { enumerable: true, get: function () { return tool_filter_1.denylist; } });
+Object.defineProperty(exports, "pattern", { enumerable: true, get: function () { return tool_filter_1.pattern; } });
+Object.defineProperty(exports, "all", { enumerable: true, get: function () { return tool_filter_1.all; } });
+Object.defineProperty(exports, "any", { enumerable: true, get: function () { return tool_filter_1.any; } });
+Object.defineProperty(exports, "filterTools", { enumerable: true, get: function () { return tool_filter_1.filterTools; } });
+// Tool error tracker — in-memory tracking for tool failure chains
 var error_tracker_1 = require("./tools/error-tracker");
 Object.defineProperty(exports, "ToolErrorTracker", { enumerable: true, get: function () { return error_tracker_1.ToolErrorTracker; } });
 Object.defineProperty(exports, "categorizeError", { enumerable: true, get: function () { return error_tracker_1.categorizeError; } });
 // Built-in file tools
 var index_1 = require("./tools/builtin/index");
 Object.defineProperty(exports, "BUILTIN_TOOLS", { enumerable: true, get: function () { return index_1.BUILTIN_TOOLS; } });
+Object.defineProperty(exports, "BUILTIN_TOOL_NAMES", { enumerable: true, get: function () { return index_1.BUILTIN_TOOL_NAMES; } });
 Object.defineProperty(exports, "registerAllBuiltinTools", { enumerable: true, get: function () { return index_1.registerAllBuiltinTools; } });
 Object.defineProperty(exports, "ReadFileTool", { enumerable: true, get: function () { return index_1.ReadFileTool; } });
 Object.defineProperty(exports, "WriteFileTool", { enumerable: true, get: function () { return index_1.WriteFileTool; } });
 Object.defineProperty(exports, "EditFileTool", { enumerable: true, get: function () { return index_1.EditFileTool; } });
 Object.defineProperty(exports, "GrepSearchTool", { enumerable: true, get: function () { return index_1.GrepSearchTool; } });
 Object.defineProperty(exports, "GlobSearchTool", { enumerable: true, get: function () { return index_1.GlobSearchTool; } });
+Object.defineProperty(exports, "createListSubagentsTool", { enumerable: true, get: function () { return index_1.createListSubagentsTool; } });
+Object.defineProperty(exports, "createSpawnSubagentTool", { enumerable: true, get: function () { return index_1.createSpawnSubagentTool; } });
+Object.defineProperty(exports, "createListErrorsTool", { enumerable: true, get: function () { return index_1.createListErrorsTool; } });
+Object.defineProperty(exports, "createSkillTool", { enumerable: true, get: function () { return index_1.createSkillTool; } });
+Object.defineProperty(exports, "createRememberTool", { enumerable: true, get: function () { return index_1.createRememberTool; } });
+Object.defineProperty(exports, "createRecallTool", { enumerable: true, get: function () { return index_1.createRecallTool; } });
 // Skills — progressive disclosure
 var index_2 = require("./skills/index");
 Object.defineProperty(exports, "SkillManager", { enumerable: true, get: function () { return index_2.SkillManager; } });
 Object.defineProperty(exports, "FileSkillLoader", { enumerable: true, get: function () { return index_2.FileSkillLoader; } });
 Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function () { return index_2.parseFrontmatter; } });
-Object.defineProperty(exports, "parseKeywords", { enumerable: true, get: function () { return index_2.parseKeywords; } });
 // Messages
 var message_1 = require("./messages/message");
 Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return message_1.Message; } });
-var types_2 = require("./messages/types");
-Object.defineProperty(exports, "Role", { enumerable: true, get: function () { return types_2.Role; } });
+var types_3 = require("./messages/types");
+Object.defineProperty(exports, "Role", { enumerable: true, get: function () { return types_3.Role; } });
+var interface_1 = require("./llm/interface");
+Object.defineProperty(exports, "LLMResponseErrorCode", { enumerable: true, get: function () { return interface_1.LLMResponseErrorCode; } });
+var token_budget_1 = require("./llm/token-budget");
+Object.defineProperty(exports, "TokenBudget", { enumerable: true, get: function () { return token_budget_1.TokenBudget; } });
+var errors_1 = require("./llm/errors");
+Object.defineProperty(exports, "LLMNetworkError", { enumerable: true, get: function () { return errors_1.LLMNetworkError; } });
+// LLM — OpenAI provider
 var openai_provider_1 = require("./llm/openai-provider");
 Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_provider_1.OpenAIProvider; } });
-Object.defineProperty(exports, "LLMNetworkError", { enumerable: true, get: function () { return openai_provider_1.LLMNetworkError; } });
 Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return openai_provider_1.isNetworkError; } });
+// LLM — Anthropic provider
+var anthropic_provider_1 = require("./llm/anthropic-provider");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return anthropic_provider_1.AnthropicProvider; } });
+// LLM — Factory
+var factory_1 = require("./llm/factory");
+Object.defineProperty(exports, "createLLMProvider", { enumerable: true, get: function () { return factory_1.createLLMProvider; } });
+// LLM — Fallback & Rate Limiting
+var fallback_provider_1 = require("./llm/fallback-provider");
+Object.defineProperty(exports, "FallbackProvider", { enumerable: true, get: function () { return fallback_provider_1.FallbackProvider; } });
+var rate_limiter_1 = require("./llm/rate-limiter");
+Object.defineProperty(exports, "RateLimitedProvider", { enumerable: true, get: function () { return rate_limiter_1.RateLimitedProvider; } });
+// LLM — Model Router
+var model_router_1 = require("./llm/model-router");
+Object.defineProperty(exports, "ModelRouter", { enumerable: true, get: function () { return model_router_1.ModelRouter; } });
 // Context
 var context_manager_1 = require("./context/context-manager");
 Object.defineProperty(exports, "ContextManager", { enumerable: true, get: function () { return context_manager_1.ContextManager; } });
-var sliding_window_1 = require("./compression/sliding-window");
-Object.defineProperty(exports, "SlidingWindowCompression", { enumerable: true, get: function () { return sliding_window_1.SlidingWindowCompression; } });
+// Compression — progressive 4-step
+var progressive_compressor_1 = require("./compression/progressive-compressor");
+Object.defineProperty(exports, "ProgressiveCompressor", { enumerable: true, get: function () { return progressive_compressor_1.ProgressiveCompressor; } });
 // User preferences
 var preference_manager_1 = require("./preferences/preference-manager");
 Object.defineProperty(exports, "PreferenceManager", { enumerable: true, get: function () { return preference_manager_1.PreferenceManager; } });
@@ -67,9 +129,55 @@ Object.defineProperty(exports, "countMessageTokens", { enumerable: true, get: fu
 // Trace — session execution trace logger
 var trace_logger_1 = require("./trace/trace-logger");
 Object.defineProperty(exports, "TraceLogger", { enumerable: true, get: function () { return trace_logger_1.TraceLogger; } });
+// Sub-agents — async multi-agent dispatch
+var index_3 = require("./subagent/index");
+Object.defineProperty(exports, "SubAgentManager", { enumerable: true, get: function () { return index_3.SubAgentManager; } });
+Object.defineProperty(exports, "SubAgentLoader", { enumerable: true, get: function () { return index_3.SubAgentLoader; } });
+// RAG — retrieval-augmented generation
+var index_4 = require("./rag/index");
+Object.defineProperty(exports, "RAGManager", { enumerable: true, get: function () { return index_4.RAGManager; } });
+Object.defineProperty(exports, "OpenAIEmbeddingProvider", { enumerable: true, get: function () { return index_4.OpenAIEmbeddingProvider; } });
+Object.defineProperty(exports, "InMemoryVectorStore", { enumerable: true, get: function () { return index_4.InMemoryVectorStore; } });
+Object.defineProperty(exports, "ChromaVectorStore", { enumerable: true, get: function () { return index_4.ChromaVectorStore; } });
+Object.defineProperty(exports, "InMemoryKeywordIndex", { enumerable: true, get: function () { return index_4.InMemoryKeywordIndex; } });
+Object.defineProperty(exports, "LLMReRanker", { enumerable: true, get: function () { return index_4.LLMReRanker; } });
+Object.defineProperty(exports, "rrfFusion", { enumerable: true, get: function () { return index_4.rrfFusion; } });
+Object.defineProperty(exports, "chunkKey", { enumerable: true, get: function () { return index_4.chunkKey; } });
 // MCP (Model Context Protocol) — dynamic tool discovery
 var mcp_client_manager_1 = require("./mcp/mcp-client-manager");
 Object.defineProperty(exports, "McpClientManager", { enumerable: true, get: function () { return mcp_client_manager_1.McpClientManager; } });
 var mcp_types_1 = require("./mcp/mcp-types");
 Object.defineProperty(exports, "McpConnectionError", { enumerable: true, get: function () { return mcp_types_1.McpConnectionError; } });
+// Project rules — user-authored, injected into system prompt
+var project_rules_1 = require("./rules/project-rules");
+Object.defineProperty(exports, "ProjectRules", { enumerable: true, get: function () { return project_rules_1.ProjectRules; } });
+// Security — prompt-injection defence helpers
+var index_5 = require("./security/index");
+Object.defineProperty(exports, "wrapUntrusted", { enumerable: true, get: function () { return index_5.wrapUntrusted; } });
+Object.defineProperty(exports, "detectInjectionSignatures", { enumerable: true, get: function () { return index_5.detectInjectionSignatures; } });
+Object.defineProperty(exports, "buildInjectionWarning", { enumerable: true, get: function () { return index_5.buildInjectionWarning; } });
+Object.defineProperty(exports, "wrapUserAuthored", { enumerable: true, get: function () { return index_5.wrapUserAuthored; } });
+Object.defineProperty(exports, "buildUserContentInjectionWarning", { enumerable: true, get: function () { return index_5.buildUserContentInjectionWarning; } });
+Object.defineProperty(exports, "wrapAndScan", { enumerable: true, get: function () { return index_5.wrapAndScan; } });
+// Logging — structured logger interface
+var index_6 = require("./logging/index");
+Object.defineProperty(exports, "ConsoleLogger", { enumerable: true, get: function () { return index_6.ConsoleLogger; } });
+Object.defineProperty(exports, "SilentLogger", { enumerable: true, get: function () { return index_6.SilentLogger; } });
+// Memory — long-term facts, rules, and project context
+var index_7 = require("./memory/index");
+Object.defineProperty(exports, "MemoryManager", { enumerable: true, get: function () { return index_7.MemoryManager; } });
+// Reflection — post-execution self-reflection with error notebook (错题本)
+var error_notebook_1 = require("./reflection/error-notebook");
+Object.defineProperty(exports, "ErrorNotebook", { enumerable: true, get: function () { return error_notebook_1.ErrorNotebook; } });
+var reflection_agent_1 = require("./reflection/reflection-agent");
+Object.defineProperty(exports, "ReflectionAgent", { enumerable: true, get: function () { return reflection_agent_1.ReflectionAgent; } });
+var memory_reflector_1 = require("./reflection/memory-reflector");
+Object.defineProperty(exports, "MemoryReflector", { enumerable: true, get: function () { return memory_reflector_1.MemoryReflector; } });
+var reflection_hook_1 = require("./reflection/reflection-hook");
+Object.defineProperty(exports, "createReflectionHook", { enumerable: true, get: function () { return reflection_hook_1.createReflectionHook; } });
+// Evaluation — tool call metrics, end-to-end testing, regression benchmarks
+var eval_1 = require("./eval");
+Object.defineProperty(exports, "ToolCallEvaluator", { enumerable: true, get: function () { return eval_1.ToolCallEvaluator; } });
+Object.defineProperty(exports, "EvalRunner", { enumerable: true, get: function () { return eval_1.EvalRunner; } });
+Object.defineProperty(exports, "Benchmark", { enumerable: true, get: function () { return eval_1.Benchmark; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,aAAa;AACb,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AAEd,kDAAgD;AAAvC,yGAAA,UAAU,OAAA;AAEnB,4DAAyD;AAAhD,kHAAA,cAAc,OAAA;AAKvB,oDAAoD;AACpD,0DAKgC;AAJ9B,qHAAA,kBAAkB,OAAA;AAClB,iIAAA,8BAA8B,OAAA;AAC9B,yHAAA,sBAAsB,OAAA;AACtB,0HAAA,uBAAuB,OAAA;AASzB,qCAAqC;AACrC,uDAAqD;AAA5C,6GAAA,YAAY,OAAA;AACrB,2DAAyD;AAAhD,iHAAA,cAAc,OAAA;AAEvB,uCAA6C;AAApC,qGAAA,YAAY,OAAA;AAGrB,6DAA6D;AAC7D,uDAA0E;AAAjE,iHAAA,gBAAgB,OAAA;AAAE,gHAAA,eAAe,OAAA;AAI1C,sBAAsB;AACtB,+CAQ+B;AAP7B,sGAAA,aAAa,OAAA;AACb,gHAAA,uBAAuB,OAAA;AACvB,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AAGhB,kCAAkC;AAClC,wCAAgG;AAAvF,qGAAA,YAAY,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAGvE,WAAW;AACX,8CAA6C;AAApC,kGAAA,OAAO,OAAA;AAChB,0CAAwC;AAA/B,6FAAA,IAAI,OAAA;AAKb,yDAAwF;AAA/E,iHAAA,cAAc,OAAA;AAAE,kHAAA,eAAe,OAAA;AAAE,iHAAA,cAAc,OAAA;AAIxD,UAAU;AACV,6DAA2D;AAAlD,iHAAA,cAAc,OAAA;AAKvB,+DAAwE;AAA/D,0HAAA,wBAAwB,OAAA;AAGjC,mBAAmB;AACnB,uEAAqE;AAA5D,uHAAA,iBAAiB,OAAA;AAG1B,2CAA2C;AAC3C,6DAA2D;AAAlD,iHAAA,cAAc,OAAA;AASvB,QAAQ;AACR,uDAAwE;AAA/D,4GAAA,WAAW,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAExC,yCAAyC;AACzC,qDAAmD;AAA1C,2GAAA,WAAW,OAAA;AAIpB,wDAAwD;AACxD,+DAA4D;AAAnD,sHAAA,gBAAgB,OAAA;AACzB,6CAAqD;AAA5C,+GAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/llm/anthropic-provider.d.ts

@@ -0,0 +1,141 @@
+import { LLMProvider, LLMResponse, LLMStreamEvent } from "./interface";
+import { MessageData } from "../messages/types";
+import { Tool } from "../tools/types";
+import { RetryConfig } from "./errors";
+/**
+ * Configuration options for the Anthropic LLM provider.
+ */
+export interface AnthropicConfig {
+    /** Anthropic API key. */
+    apiKey: string;
+    /** Model identifier (e.g. "claude-sonnet-4-6", "claude-opus-4-8"). */
+    model: string;
+    /** Sampling temperature (default: 0.7). */
+    temperature?: number;
+    /** Maximum output tokens (default: 8192). */
+    maxTokens?: number;
+    /** Custom base URL for proxies or alternative Anthropic-compatible endpoints. */
+    baseURL?: string;
+    /** Retry configuration for network resilience. */
+    retry?: RetryConfig;
+    /** Request timeout in ms (default: none). */
+    timeout?: number;
+    /**
+     * Enable Anthropic prompt caching on the system prompt.
+     *
+     * When `true`, the system prompt is sent as a content block with
+     * `cache_control: { type: "ephemeral" }`. Cached tokens are billed at
+     * 10 % of the normal input price, and the cache TTL is 5 minutes
+     * (refreshed on each hit).
+     *
+     * Best for agents with a **static** system prompt (e.g. ReActAgent).
+     * For PlanSolveAgent the plan-progress section changes each iteration
+     * which breaks cache hits — only enable if you accept cache misses.
+     *
+     * Minimum 1 024 tokens for caching to activate (Anthropic API requirement).
+     * Default: `false`.
+     */
+    cacheSystemPrompt?: boolean;
+}
+/**
+ * Anthropic implementation of the LLMProvider interface.
+ * Uses the official `@anthropic-ai/sdk` npm package.
+ *
+ * Features:
+ * - Tool/function calling support
+ * - Network error retry with exponential backoff (chat only)
+ * - Configurable timeout
+ * - Token counting via tiktoken (with model-aware encoding, falls back for Claude models)
+ *
+ * Message format conversion:
+ * The internal `MessageData[]` format (OpenAI-compatible) is converted to
+ * Anthropic's native format transparently:
+ * - System messages are extracted and passed as the top-level `system` parameter.
+ * - Tool messages (role "tool") become user messages with `tool_result` content blocks.
+ * - Assistant messages with tool_calls become content-block arrays with `tool_use` blocks.
+ */
+export declare class AnthropicProvider implements LLMProvider {
+    readonly model: string;
+    private client;
+    private temperature;
+    private maxTokens;
+    private retryConfig;
+    private timeout;
+    private cacheSystemPrompt;
+    constructor(config: AnthropicConfig);
+    /**
+     * Build the `system` parameter for the Anthropic API.
+     * When `cacheSystemPrompt` is enabled and the system prompt is non-empty,
+     * wraps it in a content block with `cache_control` so Anthropic caches it.
+     */
+    private buildSystemParam;
+    chat(messages: MessageData[], tools?: Tool[], signal?: AbortSignal): Promise<LLMResponse>;
+    chatStream(messages: MessageData[], tools?: Tool[], signal?: AbortSignal): AsyncIterable<LLMStreamEvent>;
+    /**
+     * Count tokens using tiktoken (with model-aware encoding) when available.
+     * Falls back to character-based estimation if tiktoken is not installed.
+     *
+     * Note: Claude models are not recognized by tiktoken's `encoding_for_model()`,
+     * so it falls through to the generic `o200k_base` encoding, which is a
+     * reasonable approximation for Claude's tokenizer.
+     *
+     * @param text  The text to tokenize.
+     * @param model Optional model override. Defaults to this provider's model.
+     */
+    getTokenCount(text: string, model?: string): number;
+    /**
+     * Validate and convert internal Tool definitions to Anthropic tool format.
+     *
+     * Internal format: `{ name, description, parameters }` (JSON Schema)
+     * Anthropic format: `{ name, description, input_schema }`
+     *
+     * If `parameters` is missing the required `type` field, we wrap it in
+     * an object schema as a best-effort fallback.
+     */
+    /**
+     * Build a valid Anthropic `input_schema` from a tool's raw parameters.
+     *
+     * Anthropic requires `{type: "object", properties: {...}}` at the top
+     * level. If the tool's parameters already provide this shape (i.e. it
+     * has `type: "object"`), we use `satisfies` to verify compatibility at
+     * compile time without runtime casting. Otherwise we wrap the params in
+     * an object schema.
+     */
+    private static buildInputSchema;
+    private static convertTools;
+    /**
+     * Convert an Anthropic API response to the internal `LLMResponse` format.
+     *
+     * - Text blocks → `content`
+     * - Tool use blocks → `tool_calls` with `JSON.stringify(input)`
+     * - Thinking blocks → merged into `content` (Claude extended thinking)
+     * - Usage → mapped from Anthropic's input_tokens/output_tokens
+     * - Stop reason → preserved for agents to detect truncation / tool-use
+     */
+    private static convertResponse;
+    /**
+     * Convert the internal `MessageData[]` format (OpenAI-compatible) to
+     * Anthropic's native message format.
+     *
+     * Conversion rules:
+     * 1. `role: "system"` messages are extracted, concatenated, and returned as
+     *    the top-level `systemPrompt`.
+     * 2. `role: "user"` → `{ role: "user", content: string }`
+     * 3. `role: "assistant"` without tool_calls → `{ role: "assistant", content: string }`
+     * 4. `role: "assistant"` with tool_calls → content-block array with text + tool_use blocks
+     * 5. `role: "tool"` → `{ role: "user", content: [{ type: "tool_result", ... }] }`
+     * 6. Consecutive same-role messages are merged with synthetic separators
+     *    to satisfy Anthropic's user/assistant alternation requirement.
+     * 7. If no non-system messages remain, a placeholder user message is inserted
+     *    to satisfy Anthropic's requirement of at least one user/assistant message.
+     */
+    private static convertMessages;
+    /** Counter for generating unique synthetic tool_use_ids. */
+    private static toolUseIdCounter;
+    /**
+     * Convert a single internal `MessageData` to an Anthropic `MessageParam`.
+     * Returns `null` if the message should be skipped.
+     */
+    private static convertSingleMessage;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/llm/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../src/llm/anthropic-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAQ,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAsC,WAAW,EAAE,MAAM,UAAU,CAAC;AAiE3E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,iBAAiB,CAAU;gBAEvB,MAAM,EAAE,eAAe;IA8BnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAelB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBxF,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,IAAI,EAAE,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,cAAc,CAAC;IAqFhC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAQnD;;;;;;;;OAQG;IACH;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAyB/B,OAAO,CAAC,MAAM,CAAC,YAAY;IAQ3B;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA2D9B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAkD9B,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAK;IAEpC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CA4FpC"}