@mcp-abap-adt/llm-agent-server 10.0.0

package/dist/smart-agent/otel/otel-tracer-adapter.js

@@ -0,0 +1,62 @@
+/**
+ * OpenTelemetry adapter that bridges the SmartAgent ITracer/ISpan
+ * abstraction to the @opentelemetry/api Tracer.
+ *
+ * Import from '@mcp-abap-adt/llm-agent/otel'.
+ * Requires @opentelemetry/api ^1.0.0 as a peer dependency.
+ */
+import { context, trace } from '@opentelemetry/api';
+const STATUS_MAP = {
+    ok: 1, // SpanStatusCode.OK
+    error: 2, // SpanStatusCode.ERROR
+};
+class OtelSpanAdapter {
+    otelSpan;
+    name;
+    constructor(name, otelSpan) {
+        this.otelSpan = otelSpan;
+        this.name = name;
+    }
+    setAttribute(key, value) {
+        this.otelSpan.setAttribute(key, value);
+    }
+    addEvent(name, attributes) {
+        this.otelSpan.addEvent(name, attributes);
+    }
+    setStatus(status, message) {
+        this.otelSpan.setStatus({ code: STATUS_MAP[status], message });
+    }
+    end() {
+        this.otelSpan.end();
+    }
+}
+/** Map from ISpan to the underlying OTEL span for parent-child linking. */
+const otelSpanMap = new WeakMap();
+export class OtelTracerAdapter {
+    tracer;
+    constructor(tracer) {
+        this.tracer = tracer;
+    }
+    startSpan(name, options) {
+        let ctx = context.active();
+        if (options?.parent) {
+            const parentOtel = otelSpanMap.get(options.parent);
+            if (parentOtel) {
+                ctx = trace.setSpan(ctx, parentOtel);
+            }
+        }
+        const otelSpan = this.tracer.startSpan(name, undefined, ctx);
+        if (options?.traceId) {
+            otelSpan.setAttribute('smart_agent.trace_id', options.traceId);
+        }
+        if (options?.attributes) {
+            for (const [k, v] of Object.entries(options.attributes)) {
+                otelSpan.setAttribute(k, v);
+            }
+        }
+        const adapter = new OtelSpanAdapter(name, otelSpan);
+        otelSpanMap.set(adapter, otelSpan);
+        return adapter;
+    }
+}
+//# sourceMappingURL=otel-tracer-adapter.js.map

package/dist/smart-agent/otel/otel-tracer-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-tracer-adapter.js","sourceRoot":"","sources":["../../../src/smart-agent/otel/otel-tracer-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQpD,MAAM,UAAU,GAAuC;IACrD,EAAE,EAAE,CAAmB,EAAE,oBAAoB;IAC7C,KAAK,EAAE,CAAmB,EAAE,uBAAuB;CACpD,CAAC;AAEF,MAAM,eAAe;IAKA;IAJV,IAAI,CAAS;IAEtB,YACE,IAAY,EACK,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;QAEnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,YAAY,CAAC,GAAW,EAAE,KAAgC;QACxD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CACN,IAAY,EACZ,UAAsD;QAEtD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,SAAS,CAAC,MAAkB,EAAE,OAAgB;QAC5C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,GAAG;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,WAAW,GAAG,IAAI,OAAO,EAAmB,CAAC;AAEnD,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,SAAS,CAAC,IAAY,EAAE,OAAqB;QAC3C,IAAI,GAAG,GAAY,OAAO,CAAC,MAAM,EAAE,CAAC;QAEpC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnD,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAE7D,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,QAAQ,CAAC,YAAY,CAAC,sBAAsB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxD,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/smart-agent/pipeline/condition-evaluator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Safe condition evaluator for pipeline `when` expressions.
+ *
+ * Evaluates simple dot-path property lookups against the pipeline context.
+ * Does NOT use `eval()` — only supports a restricted expression language.
+ *
+ * ## Supported expressions
+ *
+ * | Expression                      | Meaning                                       |
+ * |---------------------------------|-----------------------------------------------|
+ * | `"shouldRetrieve"`              | Truthy check on `ctx.shouldRetrieve`           |
+ * | `"config.classificationEnabled"`| Truthy check on `ctx.config.classificationEnabled` |
+ * | `"!isAscii"`                    | Negated truthy check on `ctx.isAscii`          |
+ * | `"ragResults.facts.length > 0"` | Comparison (>, <, >=, <=, ==, !=)              |
+ * | `"a && b"`                      | Logical AND of two expressions                 |
+ * | `"a || b"`                      | Logical OR of two expressions                  |
+ *
+ * ## Security
+ *
+ * - No arbitrary code execution.
+ * - No function calls.
+ * - Only reads properties from the provided context object.
+ * - Unknown paths resolve to `undefined` (falsy).
+ */
+import type { PipelineContext } from './context.js';
+/**
+ * Evaluate a condition expression against the pipeline context.
+ *
+ * @param expr - Condition string from the YAML `when` field.
+ * @param ctx  - Pipeline context providing the evaluation namespace.
+ * @returns `true` if the condition is met, `false` otherwise.
+ *          Returns `true` for `undefined` or empty expressions (no condition = always run).
+ */
+export declare function evaluateCondition(expr: string | undefined, ctx: PipelineContext): boolean;
+//# sourceMappingURL=condition-evaluator.d.ts.map

package/dist/smart-agent/pipeline/condition-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-evaluator.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/pipeline/condition-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,GAAG,EAAE,eAAe,GACnB,OAAO,CAGT"}

package/dist/smart-agent/pipeline/condition-evaluator.js

@@ -0,0 +1,143 @@
+/**
+ * Safe condition evaluator for pipeline `when` expressions.
+ *
+ * Evaluates simple dot-path property lookups against the pipeline context.
+ * Does NOT use `eval()` — only supports a restricted expression language.
+ *
+ * ## Supported expressions
+ *
+ * | Expression                      | Meaning                                       |
+ * |---------------------------------|-----------------------------------------------|
+ * | `"shouldRetrieve"`              | Truthy check on `ctx.shouldRetrieve`           |
+ * | `"config.classificationEnabled"`| Truthy check on `ctx.config.classificationEnabled` |
+ * | `"!isAscii"`                    | Negated truthy check on `ctx.isAscii`          |
+ * | `"ragResults.facts.length > 0"` | Comparison (>, <, >=, <=, ==, !=)              |
+ * | `"a && b"`                      | Logical AND of two expressions                 |
+ * | `"a || b"`                      | Logical OR of two expressions                  |
+ *
+ * ## Security
+ *
+ * - No arbitrary code execution.
+ * - No function calls.
+ * - Only reads properties from the provided context object.
+ * - Unknown paths resolve to `undefined` (falsy).
+ */
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate a condition expression against the pipeline context.
+ *
+ * @param expr - Condition string from the YAML `when` field.
+ * @param ctx  - Pipeline context providing the evaluation namespace.
+ * @returns `true` if the condition is met, `false` otherwise.
+ *          Returns `true` for `undefined` or empty expressions (no condition = always run).
+ */
+export function evaluateCondition(expr, ctx) {
+    if (!expr || expr.trim() === '')
+        return true;
+    return evaluateExpression(expr.trim(), ctx);
+}
+// ---------------------------------------------------------------------------
+// Expression evaluator
+// ---------------------------------------------------------------------------
+function evaluateExpression(expr, ctx) {
+    // Handle logical OR (lowest precedence)
+    if (expr.includes('||')) {
+        return expr
+            .split('||')
+            .some((part) => evaluateExpression(part.trim(), ctx));
+    }
+    // Handle logical AND
+    if (expr.includes('&&')) {
+        return expr
+            .split('&&')
+            .every((part) => evaluateExpression(part.trim(), ctx));
+    }
+    // Handle negation
+    if (expr.startsWith('!')) {
+        return !evaluateExpression(expr.slice(1).trim(), ctx);
+    }
+    // Handle comparison operators
+    const compMatch = expr.match(/^(.+?)\s*(>=|<=|!=|==|>|<)\s*(.+)$/);
+    if (compMatch) {
+        const left = resolveValue(compMatch[1].trim(), ctx);
+        const op = compMatch[2];
+        const right = resolveValue(compMatch[3].trim(), ctx);
+        return compare(left, op, right);
+    }
+    // Simple truthy check on a dot-path
+    return Boolean(resolveValue(expr, ctx));
+}
+// ---------------------------------------------------------------------------
+// Value resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a value from the pipeline context or parse as a literal.
+ *
+ * Supported values:
+ * - Dot-path: `"shouldRetrieve"`, `"config.ragQueryK"`, `"ragResults.facts.length"`
+ * - Numeric literal: `"10"`, `"0.5"`
+ * - String literal: `"'hard'"`, `"'smart'"`
+ * - Boolean literal: `"true"`, `"false"`
+ */
+function resolveValue(token, ctx) {
+    // Boolean literals
+    if (token === 'true')
+        return true;
+    if (token === 'false')
+        return false;
+    // Numeric literals
+    if (/^-?\d+(\.\d+)?$/.test(token))
+        return Number(token);
+    // String literals (single or double quoted)
+    const strMatch = token.match(/^['"](.*)['"]$/);
+    if (strMatch)
+        return strMatch[1];
+    // Dot-path lookup on context
+    return resolvePath(token, ctx);
+}
+/**
+ * Resolve a dot-separated path against the pipeline context.
+ *
+ * The lookup namespace is flat — the path starts from the PipelineContext root.
+ * Examples: `"shouldRetrieve"` → `ctx.shouldRetrieve`,
+ *           `"config.mode"` → `ctx.config.mode`,
+ *           `"ragResults.facts.length"` → `ctx.ragResults.facts.length`
+ */
+function resolvePath(path, ctx) {
+    const parts = path.split('.');
+    let current = ctx;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+// ---------------------------------------------------------------------------
+// Comparison
+// ---------------------------------------------------------------------------
+function compare(left, op, right) {
+    const l = typeof left === 'string' ? left : Number(left);
+    const r = typeof right === 'string' ? right : Number(right);
+    switch (op) {
+        case '==':
+            return l === r;
+        case '!=':
+            return l !== r;
+        case '>':
+            return l > r;
+        case '<':
+            return l < r;
+        case '>=':
+            return l >= r;
+        case '<=':
+            return l <= r;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=condition-evaluator.js.map

package/dist/smart-agent/pipeline/condition-evaluator.js.map

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

package/dist/smart-agent/pipeline/context.d.ts

@@ -0,0 +1,121 @@
+/**
+ * PipelineContext — mutable state bag threaded through all pipeline stages.
+ *
+ * Each stage reads its inputs from the context and writes its outputs back.
+ * The context is created fresh per request and is never shared across requests.
+ *
+ * ## Data ownership
+ *
+ * Stages must write to non-overlapping fields. For parallel execution, this
+ * means each `rag-query` handler writes to its own store slot
+ * in `ragResults`, avoiding data races.
+ *
+ * ## Streaming
+ *
+ * The `tool-loop` stage streams. It uses `ctx.yield()` to push
+ * SSE chunks back to the caller. All other stages are batch operations.
+ */
+import type { CallOptions, IContextAssembler, IEmbedder, IHistoryMemory, IHistorySummarizer, ILlm, ILlmCallStrategy, IMcpClient, IQueryEmbedding, IQueryExpander, IRagProviderRegistry, IRagRegistry, IRequestLogger, ISkill, ISkillManager, ISubpromptClassifier, LlmStreamChunk, LlmTool, McpTool, Message, RagResult, Result, Subprompt, TimingEntry } from '@mcp-abap-adt/llm-agent';
+import type { OrchestratorError, SmartAgentConfig, SmartAgentRagStores } from '../agent.js';
+import type { IToolCache } from '../cache/types.js';
+import type { ILogger } from '../logger/types.js';
+import type { IMetrics } from '../metrics/types.js';
+import type { PendingToolResultsRegistry } from '../policy/pending-tool-results-registry.js';
+import type { ToolAvailabilityRegistry } from '../policy/tool-availability-registry.js';
+import type { IPromptInjectionDetector, IToolPolicy } from '../policy/types.js';
+import type { IReranker } from '../reranker/types.js';
+import type { ISessionManager } from '../session/types.js';
+import type { ITracer } from '../tracer/types.js';
+import type { IOutputValidator } from '../validator/types.js';
+export interface PipelineContext {
+    /** Original user input (string or message array). */
+    readonly textOrMessages: string | Message[];
+    /** Call options including signal, sessionId, logger, trace. */
+    readonly options: CallOptions | undefined;
+    /** SmartAgent config snapshot for this request. */
+    readonly config: SmartAgentConfig;
+    /** Session ID (from options or 'default'). */
+    readonly sessionId: string;
+    readonly mainLlm: ILlm;
+    readonly helperLlm: ILlm | undefined;
+    readonly classifierLlm: ILlm;
+    readonly classifier: ISubpromptClassifier;
+    readonly assembler: IContextAssembler;
+    readonly ragStores: SmartAgentRagStores;
+    readonly ragRegistry: IRagRegistry | undefined;
+    readonly ragProviderRegistry: IRagProviderRegistry | undefined;
+    readonly mcpClients: IMcpClient[];
+    readonly reranker: IReranker;
+    readonly queryExpander: IQueryExpander;
+    readonly toolCache: IToolCache;
+    readonly outputValidator: IOutputValidator;
+    readonly sessionManager: ISessionManager;
+    readonly tracer: ITracer;
+    readonly metrics: IMetrics;
+    readonly logger: ILogger | undefined;
+    readonly requestLogger: IRequestLogger;
+    readonly toolPolicy: IToolPolicy | undefined;
+    readonly injectionDetector: IPromptInjectionDetector | undefined;
+    readonly toolAvailabilityRegistry: ToolAvailabilityRegistry;
+    readonly pendingToolResults: PendingToolResultsRegistry;
+    readonly skillManager: ISkillManager | undefined;
+    readonly embedder: IEmbedder | undefined;
+    readonly historyMemory: IHistoryMemory | undefined;
+    readonly historySummarizer: IHistorySummarizer | undefined;
+    readonly llmCallStrategy: ILlmCallStrategy;
+    /** Extracted user text from the last user message. */
+    inputText: string;
+    /** Conversation history (may be summarized). */
+    history: Message[];
+    /** Classified subprompts (set by classify stage). */
+    subprompts: Subprompt[];
+    /** Map of tool name → owning MCP client. */
+    toolClientMap: Map<string, IMcpClient>;
+    /** Text used for RAG queries (may be translated/expanded). */
+    ragText: string;
+    /**
+     * Enriched query text for tool/skill retrieval, composed by the
+     * `build-tool-query` stage from `ragText` + top-K RAG snippets +
+     * selected skill descriptions. When present, stages configured with
+     * `queryText: 'toolQueryText'` use this instead of `ragText`.
+     */
+    toolQueryText?: string;
+    /** Memoized query embedding, shared across all rag-query stages. */
+    queryEmbedding: IQueryEmbedding | undefined;
+    /** RAG query results per store. */
+    ragResults: Record<string, RagResult[]>;
+    /** All MCP tools from all connected servers. */
+    mcpTools: McpTool[];
+    /** Tools selected for the current request (MCP + external). */
+    selectedTools: LlmTool[];
+    /** External tools provided by the client. */
+    externalTools: LlmTool[];
+    /** Final assembled messages for LLM input. */
+    assembledMessages: Message[];
+    /** Currently active tools (after availability filtering). */
+    activeTools: LlmTool[];
+    /** Skills selected for the current request. */
+    selectedSkills: ISkill[];
+    /** Rendered skill content to inject into the system prompt. */
+    skillContent: string;
+    /** Arguments passed to skills (e.g. from slash-command invocation). */
+    skillArgs: string;
+    /** Whether RAG retrieval should run (set by classify or condition logic). */
+    shouldRetrieve: boolean;
+    /** Whether embedding usage has been logged for this request (prevents double-logging). */
+    embeddingUsageLogged?: boolean;
+    /** Whether input text is ASCII-only (affects translation decision). */
+    isAscii: boolean;
+    /** Whether SAP/ABAP context was detected. */
+    isSapRequired: boolean;
+    /** Timing entries collected from all stages. */
+    timing: TimingEntry[];
+    /** Error set by a stage to abort the pipeline. */
+    error?: OrchestratorError;
+    /**
+     * Yield a chunk to the consumer. Used by the tool-loop stage to push
+     * streaming content and heartbeats back through the SSE connection.
+     */
+    yield(chunk: Result<LlmStreamChunk, OrchestratorError>): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/smart-agent/pipeline/context.d.ts.map

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

package/dist/smart-agent/pipeline/context.js

@@ -0,0 +1,19 @@
+/**
+ * PipelineContext — mutable state bag threaded through all pipeline stages.
+ *
+ * Each stage reads its inputs from the context and writes its outputs back.
+ * The context is created fresh per request and is never shared across requests.
+ *
+ * ## Data ownership
+ *
+ * Stages must write to non-overlapping fields. For parallel execution, this
+ * means each `rag-query` handler writes to its own store slot
+ * in `ragResults`, avoiding data races.
+ *
+ * ## Streaming
+ *
+ * The `tool-loop` stage streams. It uses `ctx.yield()` to push
+ * SSE chunks back to the caller. All other stages are batch operations.
+ */
+export {};
+//# sourceMappingURL=context.js.map

package/dist/smart-agent/pipeline/context.js.map

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

package/dist/smart-agent/pipeline/default-pipeline.d.ts

@@ -0,0 +1,69 @@
+/**
+ * DefaultPipeline — IPipeline implementation backed by PipelineExecutor + stage handlers.
+ *
+ * This is the standard pipeline used by SmartAgent when no custom pipeline is
+ * configured. It runs one of two stage sequences, selected by
+ * {@link SmartAgentConfig.enrichedToolSearch}:
+ *
+ * **Single-phase (default):**
+ * ```text
+ * classify → summarize → parallel(rag-query tools, rag-query history, rag-query <custom>…) →
+ * rerank → skill-select → tool-select → assemble → tool-loop → history-upsert
+ * ```
+ *
+ * **Enriched (`enrichedToolSearch: true`):** the tools RAG store is queried in
+ * a second phase driven by context from prior retrieval + selected skills:
+ * ```text
+ * classify → summarize → parallel(rag-query history, rag-query <custom>…) →
+ * rerank → skill-select → build-tool-query → rag-query tools (enriched) →
+ * tool-select → assemble → tool-loop → history-upsert
+ * ```
+ *
+ * Built-in RAG stores (`tools`, `history`) are wired from `toolsRag`/`historyRag` deps.
+ * Additional custom stores can be passed via `ragStores` and are queried in parallel
+ * with built-ins. Stores can be added/removed at runtime via `rebuildStages()`.
+ */
+import type { CallOptions, LlmStreamChunk, LlmTool, Message, Result } from '@mcp-abap-adt/llm-agent';
+import type { OrchestratorError } from '../agent.js';
+import type { IPipeline, PipelineDeps, PipelineResult } from '../interfaces/pipeline.js';
+/**
+ * Standard IPipeline implementation that orchestrates the default SmartAgent
+ * request lifecycle via PipelineExecutor and built-in stage handlers.
+ *
+ * Usage:
+ * ```ts
+ * const pipeline = new DefaultPipeline();
+ * pipeline.initialize(deps);
+ * const result = await pipeline.execute(input, history, options, yieldChunk);
+ * ```
+ */
+export declare class DefaultPipeline implements IPipeline {
+    private deps;
+    private executor;
+    private stages;
+    private resolvedTracer;
+    private resolvedClassifier;
+    private resolvedAssembler;
+    private resolvedReranker;
+    private resolvedQueryExpander;
+    private resolvedToolCache;
+    private resolvedOutputValidator;
+    private resolvedSessionManager;
+    private resolvedMetrics;
+    private resolvedRequestLogger;
+    private resolvedLlmCallStrategy;
+    initialize(deps: PipelineDeps): void;
+    execute(input: string | Message[], history: Message[], options: CallOptions | undefined, yieldChunk: (chunk: Result<LlmStreamChunk, OrchestratorError>) => void, externalTools?: LlmTool[]): Promise<PipelineResult>;
+    rebuildStages(): void;
+    /**
+     * Build the fixed stage list. RAG parallel block only includes stores
+     * that were provided in deps.
+     */
+    private _buildStages;
+    /**
+     * Create a PipelineContext from deps + per-request input.
+     * Mirrors the pattern in SmartAgent._runStructuredPipeline().
+     */
+    private _buildContext;
+}
+//# sourceMappingURL=default-pipeline.d.ts.map

package/dist/smart-agent/pipeline/default-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-pipeline.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/pipeline/default-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,OAAO,EACP,OAAO,EACP,MAAM,EACP,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACf,MAAM,2BAA2B,CAAC;AA+BnC;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAqB;IAGnC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,qBAAqB,CAAoC;IACjE,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,uBAAuB,CAAsC;IACrE,OAAO,CAAC,sBAAsB,CAAqC;IACnE,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,qBAAqB,CAAoC;IACjE,OAAO,CAAC,uBAAuB,CAAsC;IAMrE,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA0B9B,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EACzB,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,KAAK,IAAI,EACtE,aAAa,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAAC,cAAc,CAAC;IAyB1B,aAAa,IAAI,IAAI;IAQrB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkFpB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAsFtB"}