@mcp-abap-adt/llm-agent 12.0.2 → 12.0.4

package/dist/interfaces/agent-contracts.d.ts

@@ -1,3 +1,4 @@
+import type { AgentStreamChunk, Message } from '../types.js';
 import type { CallOptions, ModelUsageEntry } from './types.js';
 import { SmartAgentError } from './types.js';
 export declare class OrchestratorError extends SmartAgentError {
@@ -28,4 +29,28 @@ export interface SmartAgentResponse {
 export interface AgentCallOptions extends CallOptions {
     externalTools?: unknown[];
 }
+/**
+ * Bridge interface for agent implementations that wrap LLM providers.
+ * Used by LlmAdapter in llm-agent-server to wrap legacy BaseAgent subclasses.
+ */
+export interface BaseAgentLlmBridge {
+    callWithTools(messages: Message[], tools: unknown[], options?: {
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        stop?: string[];
+    }): Promise<{
+        content: string;
+        raw?: unknown;
+    }>;
+    streamWithTools(messages: Message[], tools: unknown[], options?: {
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        stop?: string[];
+    }): AsyncGenerator<{
+        content: string;
+        raw?: unknown;
+    } | AgentStreamChunk, void, unknown>;
+}
 //# sourceMappingURL=agent-contracts.d.ts.map

package/dist/interfaces/agent-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contracts.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent-contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB;CAIzD;AAED,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B"}
+{"version":3,"file":"agent-contracts.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent-contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB;CAIzD;AAED,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/C,eAAe,CACb,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GACA,cAAc,CACf;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB,EACrD,IAAI,EACJ,OAAO,CACR,CAAC;CACH"}

package/dist/interfaces/agent-contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contracts.js","sourceRoot":"","sources":["../../src/interfaces/agent-contracts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,YAAY,OAAe,EAAE,IAAI,GAAG,oBAAoB;QACtD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"agent-contracts.js","sourceRoot":"","sources":["../../src/interfaces/agent-contracts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,YAAY,OAAe,EAAE,IAAI,GAAG,oBAAoB;QACtD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/interfaces/builder.d.ts

@@ -0,0 +1,55 @@
+import type { CircuitBreaker } from '../resilience/circuit-breaker.js';
+import type { Message } from '../types.js';
+import type { AgentCallOptions, OrchestratorError, SmartAgentResponse } from './agent-contracts.js';
+import type { ILlmApiAdapter } from './api-adapter.js';
+import type { ILlm } from './llm.js';
+import type { IModelProvider } from './model-provider.js';
+import type { IRag } from './rag.js';
+import type { IRequestLogger } from './request-logger.js';
+import type { LlmStreamChunk, Result } from './types.js';
+/**
+ * Public API surface of SmartAgent for consumers.
+ * The full SmartAgent class lives in @mcp-abap-adt/llm-agent-libs.
+ * SmartAgentHandle in llm-agent-libs uses the concrete SmartAgent type
+ * via the generic SmartAgentHandle<SmartAgent> specialization.
+ */
+export interface ISmartAgent {
+    process(textOrMessages: string | Message[], options?: AgentCallOptions): Promise<Result<SmartAgentResponse, OrchestratorError>>;
+    streamProcess(textOrMessages: string | Message[], options?: AgentCallOptions): AsyncIterable<Result<LlmStreamChunk, OrchestratorError>>;
+}
+/** Type alias for the RAG store map passed to SmartAgent. */
+export type SmartAgentRagStores<K extends string = string> = Record<K, IRag>;
+/**
+ * Handle returned by SmartAgentBuilder.build().
+ *
+ * Generic over the agent type so that:
+ * - Consumers coding against the public contract use `SmartAgentHandle` (default: `ISmartAgent`).
+ * - llm-agent-libs re-exports `SmartAgentHandle<SmartAgent>` to preserve full concrete typing
+ *   (including internal methods like `applyConfigUpdate`, `reconfigure`, `getActiveConfig`).
+ */
+export interface SmartAgentHandle<T extends ISmartAgent = ISmartAgent> {
+    /** The built and wired agent, ready to call .process(). */
+    agent: T;
+    /**
+     * Direct LLM chat — bypasses SmartAgent pipeline.
+     * Used by SmartServer passthrough mode to forward the full message history.
+     */
+    chat: ILlm['chat'];
+    /** Direct LLM streaming chat. */
+    streamChat: ILlm['streamChat'];
+    /** Request logger for per-model usage tracking. */
+    requestLogger: IRequestLogger;
+    /** Gracefully close MCP connections. Call on shutdown. */
+    close(): Promise<void>;
+    /** Circuit breakers (empty when not configured). */
+    circuitBreakers: CircuitBreaker[];
+    /** RAG stores (for config hot-reload weight updates). */
+    ragStores: SmartAgentRagStores;
+    /** Model provider for discovery. Undefined when not available. */
+    modelProvider?: IModelProvider;
+    /** Look up a registered API adapter by name. */
+    getApiAdapter(name: string): ILlmApiAdapter | undefined;
+    /** List all registered API adapter names. */
+    listApiAdapters(): string[];
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/interfaces/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/interfaces/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CACL,cAAc,EAAE,MAAM,GAAG,OAAO,EAAE,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC1D,aAAa,CACX,cAAc,EAAE,MAAM,GAAG,OAAO,EAAE,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC7D;AAMD,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAM7E;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACnE,2DAA2D;IAC3D,KAAK,EAAE,CAAC,CAAC;IACT;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,mDAAmD;IACnD,aAAa,EAAE,cAAc,CAAC;IAC9B,0DAA0D;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,oDAAoD;IACpD,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,yDAAyD;IACzD,SAAS,EAAE,mBAAmB,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,gDAAgD;IAChD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACxD,6CAA6C;IAC7C,eAAe,IAAI,MAAM,EAAE,CAAC;CAC7B"}

package/dist/interfaces/builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builder.js.map

package/dist/interfaces/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/interfaces/builder.ts"],"names":[],"mappings":""}

package/dist/interfaces/health.d.ts

@@ -0,0 +1,25 @@
+import type { CircuitState } from '../resilience/circuit-breaker.js';
+import type { MetricsSnapshot } from './metrics.js';
+export interface HealthComponentStatus {
+    llm: boolean;
+    rag: boolean;
+    mcp: Array<{
+        name: string;
+        ok: boolean;
+        error?: string;
+    }>;
+}
+export interface CircuitBreakerStatus {
+    index: number;
+    state: CircuitState;
+}
+export interface HealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    uptime: number;
+    version: string;
+    timestamp: string;
+    components: HealthComponentStatus;
+    circuitBreakers?: CircuitBreakerStatus[];
+    metrics?: MetricsSnapshot;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/interfaces/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/interfaces/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B"}

package/dist/interfaces/health.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.js.map

package/dist/interfaces/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/interfaces/health.ts"],"names":[],"mappings":""}

package/dist/interfaces/index.d.ts

@@ -1,20 +1,31 @@
 export type { IQueryExpander } from '../rag/query-expander.js';
-export { type AgentCallOptions, OrchestratorError, type SmartAgentResponse, type StopReason, } from './agent-contracts.js';
+export { type AgentCallOptions, type BaseAgentLlmBridge, OrchestratorError, type SmartAgentResponse, type StopReason, } from './agent-contracts.js';
 export type { HistoryEntry, IContextAssembler } from './assembler.js';
+export type { ISmartAgent, SmartAgentHandle, SmartAgentRagStores, } from './builder.js';
 export type { ISubpromptClassifier } from './classifier.js';
+export type { CircuitBreakerStatus, HealthComponentStatus, HealthStatus, } from './health.js';
 export type { IHistoryMemory } from './history-memory.js';
 export type { HistoryTurn, IHistorySummarizer, } from './history-summarizer.js';
 export type { ILlm } from './llm.js';
 export type { ILlmCallStrategy } from './llm-call-strategy.js';
 export type { IMcpClient } from './mcp-client.js';
+export type { ConnectionStrategyOptions, IMcpConnectionStrategy, McpClientFactory, McpClientFactoryResult, McpConnectionConfig, McpConnectionResult, } from './mcp-connection-strategy.js';
+export type { CounterSnapshot, HistogramSnapshot, ICounter, IHistogram, IMetrics, MetricsSnapshot, } from './metrics.js';
 export type { IModelFilter, IModelInfo, IModelProvider, } from './model-provider.js';
-export type { IRagStoreConfig, ISmartAgentPlugin, RagScope } from './plugin.js';
+export type { IModelResolver } from './model-resolver.js';
+export type { BuiltInStageType, ControlFlowType, StageDefinition, StageType, } from './pipeline.js';
+export type { IPluginLoader, IRagStoreConfig, ISmartAgentPlugin, IStageHandler, LoadedPlugins, PluginExports, RagScope, } from './plugin.js';
 export type { IQueryEmbedding } from './query-embedding.js';
 export type { EmbedderFactory, EmbedderFactoryConfig, IEmbedder, IEmbedderBatch, IEmbedResult, IIdStrategy, IRag, IRagBackendWriter, IRagEditor, IRagProvider, IRagProviderRegistry, IRagRegistry, RagCollectionMeta, RagCollectionScope, } from './rag.js';
 export { isBatchEmbedder } from './rag.js';
 export type { ILlmRateLimiter } from './rate-limiter.js';
 export type { IRequestLogger, LlmCallEntry, LlmComponent, RagQueryEntry, RequestSummary, TokenBucket, TokenCategory, ToolCallEntry, } from './request-logger.js';
+export type { IReranker } from './reranker.js';
+export type { ISessionManager } from './session.js';
 export type { ISkill, ISkillManager, ISkillMeta, ISkillResource, } from './skill.js';
+export type { ISpan, ITracer, SpanOptions, SpanStatus } from './tracer.js';
 export type { AgentConfig, CallOptions, ContextFrame, LlmFinishReason, LlmResponse, LlmStreamChunk, LlmTool, LlmToolCall, LlmToolCallDelta, LlmUsage, McpTool, McpToolResult, ModelUsageEntry, RagMetadata, RagResult, Result, StreamHookContext, StreamToolCall, Subprompt, SubpromptType, TimingEntry, ToolCallRecord, ToolHeartbeat, TraceContext, } from './types.js';
 export { AssemblerError, ClassifierError, LlmError, McpError, RagError, SkillError, SmartAgentError, } from './types.js';
+export type { IOutputValidator, ValidationResult } from './validator.js';
+export { ValidatorError } from './validator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACL,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,MAAM,EACN,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACV,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,MAAM,EACN,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/interfaces/index.js

@@ -1,4 +1,5 @@
 export { OrchestratorError, } from './agent-contracts.js';
 export { isBatchEmbedder } from './rag.js';
 export { AssemblerError, ClassifierError, LlmError, McpError, RagError, SkillError, SmartAgentError, } from './types.js';
+export { ValidatorError } from './validator.js';
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAkC9B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA4C3C,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AA2E9B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA+C3C,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/interfaces/mcp-connection-strategy.d.ts

@@ -0,0 +1,26 @@
+import type { CallOptions, ILogger, IMcpClient } from '@mcp-abap-adt/llm-agent';
+export interface McpConnectionResult {
+    clients: IMcpClient[];
+    toolsChanged: boolean;
+}
+export interface IMcpConnectionStrategy {
+    resolve(currentClients: IMcpClient[], options?: CallOptions): Promise<McpConnectionResult>;
+    dispose?(): Promise<void> | void;
+}
+export interface McpConnectionConfig {
+    type: 'http' | 'stdio';
+    url?: string;
+    command?: string;
+    args?: string[];
+}
+export interface McpClientFactoryResult {
+    client: IMcpClient;
+    close?: () => Promise<void> | void;
+}
+export type McpClientFactory = (config: McpConnectionConfig) => Promise<McpClientFactoryResult>;
+export interface ConnectionStrategyOptions {
+    skipRevectorize?: boolean;
+    logger?: ILogger;
+    cooldownMs?: number;
+}
+//# sourceMappingURL=mcp-connection-strategy.d.ts.map

package/dist/interfaces/mcp-connection-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-connection-strategy.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp-connection-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CACL,cAAc,EAAE,UAAU,EAAE,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,mBAAmB,KACxB,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/interfaces/mcp-connection-strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-connection-strategy.js.map

package/dist/interfaces/mcp-connection-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-connection-strategy.js","sourceRoot":"","sources":["../../src/interfaces/mcp-connection-strategy.ts"],"names":[],"mappings":""}

package/dist/interfaces/metrics.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Metrics interfaces — modeled after OTEL-compatible counters and histograms.
+ *
+ * Consumers implement `IMetrics` to plug in Prometheus, OTEL, or any metrics
+ * backend. The library ships `NoopMetrics` (zero overhead) and `InMemoryMetrics`
+ * (useful for testing and diagnostics).
+ */
+export interface ICounter {
+    /** Increment the counter by 1 (or a custom value). */
+    add(value?: number, attributes?: Record<string, string>): void;
+}
+export interface IHistogram {
+    /** Record a single observation (e.g. latency in ms). */
+    record(value: number, attributes?: Record<string, string>): void;
+}
+export interface IMetrics {
+    /** Total incoming requests to SmartAgent.process / streamProcess. */
+    requestCount: ICounter;
+    /** Request end-to-end latency (ms). */
+    requestLatency: IHistogram;
+    /** Number of tool calls executed (internal MCP). */
+    toolCallCount: ICounter;
+    /** Number of RAG queries executed. Attributes: store (store name), hit (true|false). */
+    ragQueryCount: ICounter;
+    /** Intent classifier invocation count. Attributes: intent (action|feedback|chat). */
+    classifierIntentCount: ICounter;
+    /** LLM chat / streamChat invocations. */
+    llmCallCount: ICounter;
+    /** LLM call latency (ms). */
+    llmCallLatency: IHistogram;
+    /** Circuit breaker state transitions. Attributes: from, to, target (llm|embedder). */
+    circuitBreakerTransition: ICounter;
+    /** Tool result cache hits. */
+    toolCacheHitCount: ICounter;
+}
+export interface CounterSnapshot {
+    total: number;
+    byAttributes: Map<string, number>;
+}
+export interface HistogramSnapshot {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    values: number[];
+}
+export interface MetricsSnapshot {
+    requestCount: CounterSnapshot;
+    requestLatency: HistogramSnapshot;
+    toolCallCount: CounterSnapshot;
+    ragQueryCount: CounterSnapshot;
+    classifierIntentCount: CounterSnapshot;
+    llmCallCount: CounterSnapshot;
+    llmCallLatency: HistogramSnapshot;
+    circuitBreakerTransition: CounterSnapshot;
+    toolCacheHitCount: CounterSnapshot;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/interfaces/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/interfaces/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,YAAY,EAAE,QAAQ,CAAC;IACvB,uCAAuC;IACvC,cAAc,EAAE,UAAU,CAAC;IAC3B,oDAAoD;IACpD,aAAa,EAAE,QAAQ,CAAC;IACxB,wFAAwF;IACxF,aAAa,EAAE,QAAQ,CAAC;IACxB,qFAAqF;IACrF,qBAAqB,EAAE,QAAQ,CAAC;IAChC,yCAAyC;IACzC,YAAY,EAAE,QAAQ,CAAC;IACvB,6BAA6B;IAC7B,cAAc,EAAE,UAAU,CAAC;IAC3B,sFAAsF;IACtF,wBAAwB,EAAE,QAAQ,CAAC;IACnC,8BAA8B;IAC9B,iBAAiB,EAAE,QAAQ,CAAC;CAC7B;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,iBAAiB,CAAC;IAClC,aAAa,EAAE,eAAe,CAAC;IAC/B,aAAa,EAAE,eAAe,CAAC;IAC/B,qBAAqB,EAAE,eAAe,CAAC;IACvC,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,iBAAiB,CAAC;IAClC,wBAAwB,EAAE,eAAe,CAAC;IAC1C,iBAAiB,EAAE,eAAe,CAAC;CACpC"}

package/dist/interfaces/metrics.js

@@ -0,0 +1,9 @@
+/**
+ * Metrics interfaces — modeled after OTEL-compatible counters and histograms.
+ *
+ * Consumers implement `IMetrics` to plug in Prometheus, OTEL, or any metrics
+ * backend. The library ships `NoopMetrics` (zero overhead) and `InMemoryMetrics`
+ * (useful for testing and diagnostics).
+ */
+export {};
+//# sourceMappingURL=metrics.js.map

package/dist/interfaces/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/interfaces/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/interfaces/model-resolver.d.ts

@@ -0,0 +1,9 @@
+import type { ILlm } from '@mcp-abap-adt/llm-agent';
+/**
+ * Resolves a model name + role into a ready-to-use ILlm instance.
+ * Used by SmartServer to handle PUT /v1/config model changes.
+ */
+export interface IModelResolver {
+    resolve(modelName: string, role: 'main' | 'classifier' | 'helper'): Promise<ILlm>;
+}
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/interfaces/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/interfaces/model-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GACrC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/interfaces/model-resolver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-resolver.js.map

package/dist/interfaces/model-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/interfaces/model-resolver.ts"],"names":[],"mappings":""}

package/dist/interfaces/pipeline.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pipeline DSL types — structured pipeline definition.
+ *
+ * A structured pipeline describes the execution topology of the SmartAgent
+ * as a tree of stages. Each stage has a type (built-in operation or control
+ * flow construct), optional config, and optional condition (`when`).
+ */
+/**
+ * Built-in stage types — each maps to an IStageHandler implementation.
+ */
+export type BuiltInStageType = 'classify' | 'summarize' | 'translate' | 'expand' | 'rag-query' | 'rerank' | 'tool-select' | 'skill-select' | 'build-tool-query' | 'assemble' | 'tool-loop' | 'history-upsert';
+/**
+ * Control flow stage types — orchestrate child stages without
+ * performing domain logic themselves.
+ */
+export type ControlFlowType = 'parallel' | 'repeat';
+/** Union of all recognized stage types. */
+export type StageType = BuiltInStageType | ControlFlowType;
+/**
+ * A single pipeline stage as parsed from structured YAML.
+ */
+export interface StageDefinition {
+    /** Unique ID within the pipeline. Used for logging, tracing, and timing entries. */
+    id: string;
+    /** Stage type — either a built-in operation or a control flow construct. */
+    type: StageType;
+    /**
+     * Arbitrary config passed to the stage handler.
+     * Each handler defines its own expected config shape.
+     */
+    config?: Record<string, unknown>;
+    /**
+     * Condition expression. When present, the stage is skipped if the
+     * expression evaluates to falsy.
+     */
+    when?: string;
+    /**
+     * Child stages — used by `parallel` and `repeat` control flow types.
+     */
+    stages?: StageDefinition[];
+    /**
+     * Sequential follow-up stages — used by `parallel` type only.
+     */
+    after?: StageDefinition[];
+    /** Maximum iterations — used by `repeat` type. Default: 10. */
+    maxIterations?: number;
+    /**
+     * Stop condition — used by `repeat` type.
+     */
+    until?: string;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/interfaces/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/interfaces/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,UAAU,GACV,WAAW,GACX,gBAAgB,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAM3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IAEX,4EAA4E;IAC5E,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAE1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/interfaces/pipeline.js

@@ -0,0 +1,9 @@
+/**
+ * Pipeline DSL types — structured pipeline definition.
+ *
+ * A structured pipeline describes the execution topology of the SmartAgent
+ * as a tree of stages. Each stage has a type (built-in operation or control
+ * flow construct), optional config, and optional condition (`when`).
+ */
+export {};
+//# sourceMappingURL=pipeline.js.map

package/dist/interfaces/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/interfaces/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/interfaces/plugin.d.ts

@@ -4,7 +4,14 @@
  * Plugins allow consumers to attach named RAG stores (with lifecycle scopes)
  * and extend classifier prompts without modifying core agent code.
  */
-import type { IRag } from './rag.js';
+import type { IQueryExpander } from '../rag/query-expander.js';
+import type { ILlmApiAdapter } from './api-adapter.js';
+import type { IClientAdapter } from './client-adapter.js';
+import type { IMcpClient } from './mcp-client.js';
+import type { EmbedderFactory, IRag } from './rag.js';
+import type { IReranker } from './reranker.js';
+import type { ISkillManager } from './skill.js';
+import type { IOutputValidator } from './validator.js';
 /**
  * Lifecycle scope of a RAG store provided by a plugin.
  *
@@ -48,4 +55,77 @@ export interface ISmartAgentPlugin {
      */
     classifierPromptExtension?: string;
 }
+/**
+ * Stage handler interface for pipeline extensibility.
+ *
+ * Generic over the pipeline context type so that:
+ * - Consumers coding against the public contract use `IStageHandler` (default: `unknown`).
+ * - llm-agent-libs re-exports `IStageHandler<PipelineContext>` to preserve full
+ *   concrete typing for internal handlers.
+ */
+export interface IStageHandler<TContext = unknown> {
+    execute(ctx: TContext, config: Record<string, unknown>, span: unknown): Promise<boolean>;
+}
+/**
+ * Shape of a plugin module's named exports.
+ * All fields are optional — a plugin can register any subset.
+ */
+export interface PluginExports {
+    /** Custom pipeline stage handlers, keyed by stage type name. */
+    stageHandlers?: Record<string, IStageHandler>;
+    /** Custom embedder factories, keyed by embedder name. */
+    embedderFactories?: Record<string, EmbedderFactory>;
+    /** Custom RAG reranker (replaces the default). */
+    reranker?: IReranker;
+    /** Custom query expander (replaces the default). */
+    queryExpander?: IQueryExpander;
+    /** Custom output validator (replaces the default). */
+    outputValidator?: IOutputValidator;
+    /** Custom skill manager (replaces the default). */
+    skillManager?: ISkillManager;
+    /** Pre-built MCP clients (accumulated from all plugins). */
+    mcpClients?: IMcpClient[];
+    /** Client adapters for auto-detecting prompt-based clients (accumulated). */
+    clientAdapters?: IClientAdapter[];
+    /** API protocol adapters, keyed by adapter name. */
+    apiAdapters?: Record<string, ILlmApiAdapter>;
+}
+/**
+ * Result of loading all plugins.
+ * Merged registrations from all discovered plugin sources.
+ */
+export interface LoadedPlugins {
+    stageHandlers: Map<string, IStageHandler>;
+    embedderFactories: Record<string, EmbedderFactory>;
+    reranker?: IReranker;
+    queryExpander?: IQueryExpander;
+    outputValidator?: IOutputValidator;
+    skillManager?: ISkillManager;
+    mcpClients: IMcpClient[];
+    clientAdapters: IClientAdapter[];
+    apiAdapters: Map<string, ILlmApiAdapter>;
+    /** Source identifiers for successfully loaded plugins. */
+    loadedFiles: string[];
+    /** Plugins that failed to load, with error messages. */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+/**
+ * Plugin loader interface.
+ *
+ * Abstracts how plugins are discovered and loaded. The library ships
+ * a default filesystem-based implementation (`FileSystemPluginLoader`).
+ * Consumers can provide their own implementation to load plugins from
+ * npm packages, remote registries, databases, or any other source.
+ */
+export interface IPluginLoader {
+    /**
+     * Discover and load plugins.
+     *
+     * @returns Merged plugin registrations from all discovered sources.
+     */
+    load(): Promise<LoadedPlugins>;
+}
 //# sourceMappingURL=plugin.d.ts.map

package/dist/interfaces/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/interfaces/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAMrC;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,GAAG,EAAE,IAAI,CAAC;IACV,+DAA+D;IAC/D,KAAK,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/interfaces/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMvD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,GAAG,EAAE,IAAI,CAAC;IACV,+DAA+D;IAC/D,KAAK,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO;IAC/C,OAAO,CACL,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE9C,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEpD,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,oDAAoD;IACpD,aAAa,CAAC,EAAE,cAAc,CAAC;IAE/B,sDAAsD;IACtD,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC,mDAAmD;IACnD,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAE1B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAElC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CAChC"}

package/dist/interfaces/reranker.d.ts

@@ -0,0 +1,5 @@
+import type { CallOptions, RagError, RagResult, Result } from './types.js';
+export interface IReranker {
+    rerank(query: string, results: RagResult[], options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+}
+//# sourceMappingURL=reranker.d.ts.map

package/dist/interfaces/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../../src/interfaces/reranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;CAC3C"}

package/dist/interfaces/reranker.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reranker.js.map

package/dist/interfaces/reranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.js","sourceRoot":"","sources":["../../src/interfaces/reranker.ts"],"names":[],"mappings":""}

package/dist/interfaces/session.d.ts

@@ -0,0 +1,7 @@
+export interface ISessionManager {
+    addTokens(count: number): void;
+    isOverBudget(): boolean;
+    reset(): void;
+    readonly totalTokens: number;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/interfaces/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/interfaces/session.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,IAAI,OAAO,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/interfaces/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/interfaces/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/interfaces/session.ts"],"names":[],"mappings":""}

package/dist/interfaces/tracer.d.ts

@@ -0,0 +1,17 @@
+export type SpanStatus = 'ok' | 'error';
+export interface SpanOptions {
+    parent?: ISpan;
+    attributes?: Record<string, string | number | boolean>;
+    traceId?: string;
+}
+export interface ISpan {
+    readonly name: string;
+    setAttribute(key: string, value: string | number | boolean): void;
+    addEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
+    setStatus(status: SpanStatus, message?: string): void;
+    end(): void;
+}
+export interface ITracer {
+    startSpan(name: string, options?: SpanOptions): ISpan;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/interfaces/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/interfaces/tracer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI,CAAC;IACR,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,GAAG,IAAI,IAAI,CAAC;CACb;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;CACvD"}

package/dist/interfaces/tracer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracer.js.map

package/dist/interfaces/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/interfaces/tracer.ts"],"names":[],"mappings":""}

package/dist/interfaces/validator.d.ts

@@ -0,0 +1,18 @@
+import type { Message } from '../types.js';
+import type { CallOptions, LlmTool, Result } from './types.js';
+import { SmartAgentError } from './types.js';
+export interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+    correctedContent?: string;
+}
+export declare class ValidatorError extends SmartAgentError {
+    constructor(message: string, code?: string);
+}
+export interface IOutputValidator {
+    validate(content: string, context: {
+        messages: Message[];
+        tools: LlmTool[];
+    }, options?: CallOptions): Promise<Result<ValidationResult, ValidatorError>>;
+}
+//# sourceMappingURL=validator.d.ts.map