@mcp-abap-adt/llm-agent 2.9.2 → 2.10.0

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

@@ -0,0 +1,118 @@
+/**
+ * Default pipeline definition — matches the current hardcoded SmartAgent flow.
+ *
+ * This serves two purposes:
+ * 1. **Documentation** — shows exactly what stages the default pipeline runs.
+ * 2. **Fallback** — used when no custom pipeline is defined.
+ *
+ * ## Default pipeline stages
+ *
+ * ```text
+ * classify           — decompose user input into typed subprompts
+ *   ↓
+ * summarize          — condense history if too long (conditional)
+ *   ↓
+ * rag-upsert         — upsert fact/state/feedback to RAG (conditional)
+ *   ↓
+ * rag-retrieval      — parallel block (conditional on shouldRetrieve):
+ *   ├─ translate      — translate non-ASCII to English
+ *   └─ expand         — expand query with synonyms
+ *   after:
+ *   ├─ rag-query ×3   — query facts/feedback/state in parallel
+ *   └─ rerank         — re-score RAG results
+ *   ↓
+ * tool-select         — ALWAYS runs (queries facts RAG if retrieval was skipped)
+ *   ↓
+ * assemble           — build final LLM context
+ *   ↓
+ * tool-loop           — streaming LLM + tool execution loop
+ * ```
+ */
+/**
+ * Returns the default pipeline stage definitions.
+ *
+ * This matches the behavior of `SmartAgent.streamProcess()` when no
+ * structured pipeline is configured.
+ */
+export function getDefaultPipelineDefinition() {
+    return {
+        version: '1',
+        stages: getDefaultStages(),
+    };
+}
+/**
+ * Returns the default stage list.
+ * Exported separately for composition — consumers can use this as a base
+ * and add/remove/reorder stages.
+ */
+export function getDefaultStages() {
+    return [
+        {
+            id: 'classify',
+            type: 'classify',
+        },
+        {
+            id: 'summarize',
+            type: 'summarize',
+        },
+        {
+            id: 'rag-upsert',
+            type: 'rag-upsert',
+        },
+        {
+            id: 'rag-retrieval',
+            type: 'parallel',
+            when: 'shouldRetrieve',
+            stages: [
+                {
+                    id: 'translate',
+                    type: 'translate',
+                },
+                {
+                    id: 'expand',
+                    type: 'expand',
+                },
+            ],
+            after: [
+                {
+                    id: 'rag-query',
+                    type: 'parallel',
+                    stages: [
+                        {
+                            id: 'rag-facts',
+                            type: 'rag-query',
+                            config: { store: 'facts' },
+                        },
+                        {
+                            id: 'rag-feedback',
+                            type: 'rag-query',
+                            config: { store: 'feedback' },
+                        },
+                        {
+                            id: 'rag-state',
+                            type: 'rag-query',
+                            config: { store: 'state' },
+                        },
+                    ],
+                },
+                {
+                    id: 'rerank',
+                    type: 'rerank',
+                },
+            ],
+        },
+        {
+            id: 'tool-select',
+            type: 'tool-select',
+        },
+        {
+            id: 'assemble',
+            type: 'assemble',
+        },
+        {
+            id: 'tool-loop',
+            type: 'tool-loop',
+        },
+    ];
+}
+//# sourceMappingURL=default-pipeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-pipeline.js","sourceRoot":"","sources":["../../../src/smart-agent/pipeline/default-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,gBAAgB,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL;YACE,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,UAAU;SACjB;QACD;YACE,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,WAAW;SAClB;QACD;YACE,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,YAAY;SACnB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,WAAW;oBACf,IAAI,EAAE,WAAW;iBAClB;gBACD;oBACE,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,WAAW;oBACf,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE;wBACN;4BACE,EAAE,EAAE,WAAW;4BACf,IAAI,EAAE,WAAW;4BACjB,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;yBAC3B;wBACD;4BACE,EAAE,EAAE,cAAc;4BAClB,IAAI,EAAE,WAAW;4BACjB,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;yBAC9B;wBACD;4BACE,EAAE,EAAE,WAAW;4BACf,IAAI,EAAE,WAAW;4BACjB,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;yBAC3B;qBACF;iBACF;gBACD;oBACE,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,QAAQ;iBACf;aACF;SACF;QACD;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,aAAa;SACpB;QACD;YACE,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,UAAU;SACjB;QACD;YACE,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,WAAW;SAClB;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * PipelineExecutor — walks a stage definition tree and dispatches to handlers.
+ *
+ * The executor is the engine that interprets the structured pipeline YAML.
+ * It handles three execution modes:
+ *
+ * 1. **Sequential** (default) — stages in a list run one after another.
+ * 2. **Parallel** — child stages run concurrently via `Promise.all`.
+ *    Optional `after` stages run sequentially after all children complete.
+ * 3. **Repeat** — child stages run in a loop until a condition or max iterations.
+ *
+ * ## Condition evaluation
+ *
+ * Each stage can have a `when` field — a condition expression evaluated
+ * against the {@link PipelineContext}. If the condition is falsy, the stage
+ * is skipped. See {@link evaluateCondition} for supported expression syntax.
+ *
+ * ## Error handling
+ *
+ * If a handler returns `false` or sets `ctx.error`, the executor stops
+ * processing and propagates the error back to the caller.
+ *
+ * ## Tracing
+ *
+ * Each stage execution is wrapped in a tracer span named `pipeline.<stage.id>`.
+ * The span is passed to the handler for sub-span creation.
+ */
+import type { ISpan, ITracer } from '../tracer/types.js';
+import type { PipelineContext } from './context.js';
+import type { StageHandlerRegistry } from './handlers/index.js';
+import type { StageDefinition } from './types.js';
+export declare class PipelineExecutor {
+    private readonly handlers;
+    private readonly tracer;
+    constructor(handlers: StageHandlerRegistry, tracer: ITracer);
+    /**
+     * Execute a list of stages sequentially.
+     *
+     * @param stages    - Stage definitions to execute in order.
+     * @param ctx       - Mutable pipeline context.
+     * @param parentSpan - Parent tracing span.
+     * @returns `true` if all stages completed successfully, `false` if aborted.
+     */
+    executeStages(stages: StageDefinition[], ctx: PipelineContext, parentSpan: ISpan): Promise<boolean>;
+    /**
+     * Execute child stages in parallel, then run `after` stages sequentially.
+     */
+    private _executeParallel;
+    /**
+     * Execute child stages in a loop until condition or max iterations.
+     */
+    private _executeRepeat;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/pipeline/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,OAAO;IAGlC;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,eAAe,EAAE,EACzB,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,KAAK,GAChB,OAAO,CAAC,OAAO,CAAC;IAyDnB;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;YACW,cAAc;CAkB7B"}

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

@@ -0,0 +1,133 @@
+/**
+ * PipelineExecutor — walks a stage definition tree and dispatches to handlers.
+ *
+ * The executor is the engine that interprets the structured pipeline YAML.
+ * It handles three execution modes:
+ *
+ * 1. **Sequential** (default) — stages in a list run one after another.
+ * 2. **Parallel** — child stages run concurrently via `Promise.all`.
+ *    Optional `after` stages run sequentially after all children complete.
+ * 3. **Repeat** — child stages run in a loop until a condition or max iterations.
+ *
+ * ## Condition evaluation
+ *
+ * Each stage can have a `when` field — a condition expression evaluated
+ * against the {@link PipelineContext}. If the condition is falsy, the stage
+ * is skipped. See {@link evaluateCondition} for supported expression syntax.
+ *
+ * ## Error handling
+ *
+ * If a handler returns `false` or sets `ctx.error`, the executor stops
+ * processing and propagates the error back to the caller.
+ *
+ * ## Tracing
+ *
+ * Each stage execution is wrapped in a tracer span named `pipeline.<stage.id>`.
+ * The span is passed to the handler for sub-span creation.
+ */
+import { evaluateCondition } from './condition-evaluator.js';
+export class PipelineExecutor {
+    handlers;
+    tracer;
+    constructor(handlers, tracer) {
+        this.handlers = handlers;
+        this.tracer = tracer;
+    }
+    /**
+     * Execute a list of stages sequentially.
+     *
+     * @param stages    - Stage definitions to execute in order.
+     * @param ctx       - Mutable pipeline context.
+     * @param parentSpan - Parent tracing span.
+     * @returns `true` if all stages completed successfully, `false` if aborted.
+     */
+    async executeStages(stages, ctx, parentSpan) {
+        for (const stage of stages) {
+            if (ctx.error)
+                return false;
+            if (ctx.options?.signal?.aborted)
+                return false;
+            // Evaluate `when` condition
+            const shouldRun = evaluateCondition(stage.when, ctx);
+            if (!shouldRun) {
+                ctx.options?.sessionLogger?.logStep(`stage_skipped_${stage.id}`, {
+                    reason: stage.when,
+                });
+                continue;
+            }
+            const span = this.tracer.startSpan(`pipeline.${stage.id}`, {
+                parent: parentSpan,
+                attributes: { 'stage.type': stage.type },
+            });
+            const stageStart = Date.now();
+            let ok;
+            try {
+                if (stage.type === 'parallel') {
+                    ok = await this._executeParallel(stage, ctx, span);
+                }
+                else if (stage.type === 'repeat') {
+                    ok = await this._executeRepeat(stage, ctx, span);
+                }
+                else {
+                    const handler = this.handlers.get(stage.type);
+                    if (!handler) {
+                        throw new Error(`Unknown stage type "${stage.type}" in stage "${stage.id}". ` +
+                            `Available types: ${[...this.handlers.keys()].join(', ')}, parallel, repeat`);
+                    }
+                    ok = await handler.execute(ctx, stage.config ?? {}, span);
+                }
+            }
+            catch (err) {
+                span.setStatus('error', String(err));
+                span.end();
+                ctx.options?.sessionLogger?.logStep(`stage_error_${stage.id}`, {
+                    error: String(err),
+                });
+                return false;
+            }
+            ctx.timing.push({
+                phase: stage.id,
+                duration: Date.now() - stageStart,
+            });
+            span.setStatus(ok ? 'ok' : 'error');
+            span.end();
+            if (!ok)
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Execute child stages in parallel, then run `after` stages sequentially.
+     */
+    async _executeParallel(stage, ctx, parentSpan) {
+        if (!stage.stages?.length)
+            return true;
+        const results = await Promise.all(stage.stages.map((child) => this.executeStages([child], ctx, parentSpan)));
+        if (results.some((r) => !r))
+            return false;
+        // Run sequential `after` stages after all parallel children complete
+        if (stage.after?.length) {
+            return this.executeStages(stage.after, ctx, parentSpan);
+        }
+        return true;
+    }
+    /**
+     * Execute child stages in a loop until condition or max iterations.
+     */
+    async _executeRepeat(stage, ctx, parentSpan) {
+        const max = stage.maxIterations ?? 10;
+        for (let i = 0; i < max; i++) {
+            // Check `until` stop condition
+            if (stage.until && evaluateCondition(stage.until, ctx)) {
+                break;
+            }
+            if (stage.stages) {
+                const ok = await this.executeStages(stage.stages, ctx, parentSpan);
+                if (!ok)
+                    return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=executor.js.map

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

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

package/dist/smart-agent/pipeline/handlers/assemble.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AssembleHandler — builds the final LLM context from action + retrieved + history.
+ *
+ * Reads: `ctx.subprompts`, `ctx.ragResults`, `ctx.mcpTools` (selected), `ctx.history`
+ * Writes: `ctx.assembledMessages`
+ *
+ * Merges multiple action subprompts into a single action, then delegates
+ * to the injected IContextAssembler.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class AssembleHandler implements IStageHandler {
+    execute(ctx: PipelineContext, _config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=assemble.d.ts.map

package/dist/smart-agent/pipeline/handlers/assemble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,eAAgB,YAAW,aAAa;IAC7C,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,OAAO,CAAC;CAgEpB"}

package/dist/smart-agent/pipeline/handlers/assemble.js

@@ -0,0 +1,57 @@
+/**
+ * AssembleHandler — builds the final LLM context from action + retrieved + history.
+ *
+ * Reads: `ctx.subprompts`, `ctx.ragResults`, `ctx.mcpTools` (selected), `ctx.history`
+ * Writes: `ctx.assembledMessages`
+ *
+ * Merges multiple action subprompts into a single action, then delegates
+ * to the injected IContextAssembler.
+ */
+import { OrchestratorError } from '../../agent.js';
+export class AssembleHandler {
+    async execute(ctx, _config, span) {
+        const actions = ctx.subprompts.filter((sp) => sp.type === 'action');
+        // Merge multiple actions into one
+        const mainAction = actions.length > 1
+            ? {
+                type: 'action',
+                text: actions.map((a) => a.text).join('\n'),
+                context: actions.find((a) => a.context)?.context,
+                dependency: 'independent',
+            }
+            : actions.length === 1
+                ? actions[0]
+                : (ctx.subprompts.find((sp) => sp.type === 'chat') ??
+                    ctx.subprompts[0]);
+        if (actions.length > 1) {
+            ctx.options?.sessionLogger?.logStep('actions_merged', {
+                count: actions.length,
+                actions: actions.map((a) => ({
+                    text: a.text,
+                    dependency: a.dependency,
+                })),
+            });
+        }
+        // Build retrieved context — select tools that were chosen
+        const selectedMcpTools = ctx.mcpTools.filter((t) => ctx.activeTools.some((at) => at.name === t.name));
+        const retrieved = {
+            facts: ctx.ragResults.facts,
+            feedback: ctx.ragResults.feedback,
+            state: ctx.ragResults.state,
+            tools: selectedMcpTools,
+        };
+        const result = await ctx.assembler.assemble(mainAction, retrieved, ctx.history, ctx.options);
+        if (!result.ok) {
+            ctx.error = new OrchestratorError(result.error.message, 'ASSEMBLER_ERROR');
+            return false;
+        }
+        ctx.assembledMessages = result.value;
+        ctx.options?.sessionLogger?.logStep('final_context_assembled', {
+            messages: result.value,
+            tools: ctx.activeTools.map((t) => t.name),
+        });
+        span.setAttribute('message_count', result.value.length);
+        return true;
+    }
+}
+//# sourceMappingURL=assemble.js.map

package/dist/smart-agent/pipeline/handlers/assemble.js.map

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

package/dist/smart-agent/pipeline/handlers/classify.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ClassifyHandler — decomposes user input into typed subprompts.
+ *
+ * Reads: `ctx.inputText`
+ * Writes: `ctx.subprompts`, `ctx.isSapRequired`, `ctx.shouldRetrieve`
+ *
+ * When classification is disabled (`config.classificationEnabled === false`),
+ * the input is treated as a single action subprompt.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class ClassifyHandler implements IStageHandler {
+    execute(ctx: PipelineContext, _config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+    /**
+     * Update control flags based on classified subprompts.
+     * These flags are used by `when` conditions on downstream stages.
+     */
+    private _updateControlFlags;
+}
+//# sourceMappingURL=classify.d.ts.map

package/dist/smart-agent/pipeline/handlers/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,eAAgB,YAAW,aAAa;IAC7C,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,OAAO,CAAC;IAmCnB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAU5B"}

package/dist/smart-agent/pipeline/handlers/classify.js

@@ -0,0 +1,53 @@
+/**
+ * ClassifyHandler — decomposes user input into typed subprompts.
+ *
+ * Reads: `ctx.inputText`
+ * Writes: `ctx.subprompts`, `ctx.isSapRequired`, `ctx.shouldRetrieve`
+ *
+ * When classification is disabled (`config.classificationEnabled === false`),
+ * the input is treated as a single action subprompt.
+ */
+import { OrchestratorError } from '../../agent.js';
+export class ClassifyHandler {
+    async execute(ctx, _config, span) {
+        if (ctx.config.classificationEnabled === false) {
+            ctx.subprompts = [
+                { type: 'action', text: ctx.inputText, dependency: 'independent' },
+            ];
+            ctx.options?.sessionLogger?.logStep('classification_skipped', {
+                text: ctx.inputText,
+            });
+            span.setAttribute('skipped', true);
+            this._updateControlFlags(ctx);
+            return true;
+        }
+        const result = await ctx.classifier.classify(ctx.inputText, ctx.options);
+        if (!result.ok) {
+            ctx.error = new OrchestratorError(result.error.message, 'CLASSIFIER_ERROR');
+            return false;
+        }
+        ctx.subprompts = result.value;
+        ctx.options?.sessionLogger?.logStep('classifier_response', {
+            subprompts: result.value,
+        });
+        for (const sp of ctx.subprompts) {
+            ctx.metrics.classifierIntentCount.add(1, { intent: sp.type });
+        }
+        this._updateControlFlags(ctx);
+        return true;
+    }
+    /**
+     * Update control flags based on classified subprompts.
+     * These flags are used by `when` conditions on downstream stages.
+     */
+    _updateControlFlags(ctx) {
+        const actions = ctx.subprompts.filter((sp) => sp.type === 'action');
+        const mode = ctx.config.mode || 'smart';
+        ctx.isSapRequired =
+            actions.some((a) => a.context === 'sap-abap') || mode === 'hard';
+        const ragMode = ctx.config.ragRetrievalMode ?? 'auto';
+        ctx.shouldRetrieve =
+            ragMode === 'always' || (ragMode === 'auto' && ctx.isSapRequired);
+    }
+}
+//# sourceMappingURL=classify.js.map

package/dist/smart-agent/pipeline/handlers/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,OAAgC,EAChC,IAAW;QAEX,IAAI,GAAG,CAAC,MAAM,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;YAC/C,GAAG,CAAC,UAAU,GAAG;gBACf,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE;aACnE,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,wBAAwB,EAAE;gBAC5D,IAAI,EAAE,GAAG,CAAC,SAAS;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,EACpB,kBAAkB,CACnB,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9B,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,qBAAqB,EAAE;YACzD,UAAU,EAAE,MAAM,CAAC,KAAK;SACzB,CAAC,CAAC;QAEH,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAChC,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,GAAoB;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC;QACxC,GAAG,CAAC,aAAa;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC;QAEnE,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC;QACtD,GAAG,CAAC,cAAc;YAChB,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/smart-agent/pipeline/handlers/expand.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ExpandHandler — expands RAG query with synonyms and related terms.
+ *
+ * Reads: `ctx.ragText`, `ctx.queryExpander`
+ * Writes: `ctx.ragText`
+ *
+ * Uses the injected IQueryExpander to broaden RAG queries.
+ * Skipped when `queryExpansionEnabled` is false.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class ExpandHandler implements IStageHandler {
+    execute(ctx: PipelineContext, _config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=expand.d.ts.map

package/dist/smart-agent/pipeline/handlers/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,aAAc,YAAW,aAAa;IAC3C,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,OAAO,CAAC;CAcpB"}

package/dist/smart-agent/pipeline/handlers/expand.js

@@ -0,0 +1,24 @@
+/**
+ * ExpandHandler — expands RAG query with synonyms and related terms.
+ *
+ * Reads: `ctx.ragText`, `ctx.queryExpander`
+ * Writes: `ctx.ragText`
+ *
+ * Uses the injected IQueryExpander to broaden RAG queries.
+ * Skipped when `queryExpansionEnabled` is false.
+ */
+export class ExpandHandler {
+    async execute(ctx, _config, span) {
+        if (!ctx.config.queryExpansionEnabled) {
+            span.setAttribute('skipped', true);
+            return true;
+        }
+        const result = await ctx.queryExpander.expand(ctx.ragText, ctx.options);
+        if (result.ok) {
+            ctx.ragText = result.value;
+            span.setAttribute('expanded', true);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=expand.js.map

package/dist/smart-agent/pipeline/handlers/expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.js","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,OAAgC,EAChC,IAAW;QAEX,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/smart-agent/pipeline/handlers/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Default stage handler registry.
+ *
+ * Maps built-in stage type names to their handler implementations.
+ * Custom handlers can be added via `SmartAgentBuilder.withStageHandler()`.
+ */
+import type { IStageHandler } from '../stage-handler.js';
+import { AssembleHandler } from './assemble.js';
+import { ClassifyHandler } from './classify.js';
+import { ExpandHandler } from './expand.js';
+import { RagQueryHandler } from './rag-query.js';
+import { RagUpsertHandler } from './rag-upsert.js';
+import { RerankHandler } from './rerank.js';
+import { SummarizeHandler } from './summarize.js';
+import { ToolLoopHandler } from './tool-loop.js';
+import { ToolSelectHandler } from './tool-select.js';
+import { TranslateHandler } from './translate.js';
+export type StageHandlerRegistry = Map<string, IStageHandler>;
+/**
+ * Build the default handler registry with all built-in stage handlers.
+ *
+ * The registry maps stage type names (as used in YAML) to their handler
+ * instances. All handlers are stateless — they read/write through the
+ * {@link PipelineContext}.
+ */
+export declare function buildDefaultHandlerRegistry(): StageHandlerRegistry;
+export { AssembleHandler, ClassifyHandler, ExpandHandler, RagQueryHandler, RagUpsertHandler, RerankHandler, SummarizeHandler, ToolLoopHandler, ToolSelectHandler, TranslateHandler, };
+//# sourceMappingURL=index.d.ts.map

package/dist/smart-agent/pipeline/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,oBAAoB,CAalE;AAED,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}

package/dist/smart-agent/pipeline/handlers/index.js

@@ -0,0 +1,39 @@
+/**
+ * Default stage handler registry.
+ *
+ * Maps built-in stage type names to their handler implementations.
+ * Custom handlers can be added via `SmartAgentBuilder.withStageHandler()`.
+ */
+import { AssembleHandler } from './assemble.js';
+import { ClassifyHandler } from './classify.js';
+import { ExpandHandler } from './expand.js';
+import { RagQueryHandler } from './rag-query.js';
+import { RagUpsertHandler } from './rag-upsert.js';
+import { RerankHandler } from './rerank.js';
+import { SummarizeHandler } from './summarize.js';
+import { ToolLoopHandler } from './tool-loop.js';
+import { ToolSelectHandler } from './tool-select.js';
+import { TranslateHandler } from './translate.js';
+/**
+ * Build the default handler registry with all built-in stage handlers.
+ *
+ * The registry maps stage type names (as used in YAML) to their handler
+ * instances. All handlers are stateless — they read/write through the
+ * {@link PipelineContext}.
+ */
+export function buildDefaultHandlerRegistry() {
+    return new Map([
+        ['classify', new ClassifyHandler()],
+        ['summarize', new SummarizeHandler()],
+        ['rag-upsert', new RagUpsertHandler()],
+        ['translate', new TranslateHandler()],
+        ['expand', new ExpandHandler()],
+        ['rag-query', new RagQueryHandler()],
+        ['rerank', new RerankHandler()],
+        ['tool-select', new ToolSelectHandler()],
+        ['assemble', new AssembleHandler()],
+        ['tool-loop', new ToolLoopHandler()],
+    ]);
+}
+export { AssembleHandler, ClassifyHandler, ExpandHandler, RagQueryHandler, RagUpsertHandler, RerankHandler, SummarizeHandler, ToolLoopHandler, ToolSelectHandler, TranslateHandler, };
+//# sourceMappingURL=index.js.map

package/dist/smart-agent/pipeline/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlD;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,GAAG,CAAwB;QACpC,CAAC,UAAU,EAAE,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACrC,CAAC,YAAY,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACtC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACrC,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QACpC,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC,aAAa,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACxC,CAAC,UAAU,EAAE,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;KACrC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}

package/dist/smart-agent/pipeline/handlers/rag-query.d.ts

@@ -0,0 +1,25 @@
+/**
+ * RagQueryHandler — queries a single RAG store.
+ *
+ * Reads: `ctx.ragText`, `ctx.ragStores`
+ * Writes: `ctx.ragResults[store]` where `store` is from config
+ *
+ * ## Config
+ *
+ * | Field   | Type   | Default  | Description                          |
+ * |---------|--------|----------|--------------------------------------|
+ * | `store` | string | required | Which store: `'facts'`, `'feedback'`, `'state'` |
+ * | `k`     | number | from ctx | Number of results to retrieve        |
+ *
+ * ## Parallel safety
+ *
+ * Each instance writes to a different slot in `ctx.ragResults`, so
+ * multiple rag-query stages can safely run in parallel.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class RagQueryHandler implements IStageHandler {
+    execute(ctx: PipelineContext, config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=rag-query.d.ts.map