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

package/dist/smart-agent/pipeline/handlers/tool-loop.js

@@ -0,0 +1,416 @@
+/**
+ * ToolLoopHandler — streaming LLM call + MCP tool execution loop.
+ *
+ * This is the "terminal" pipeline stage. It takes over the streaming yield
+ * mechanism to push SSE chunks back to the consumer.
+ *
+ * Reads: `ctx.assembledMessages`, `ctx.activeTools`, `ctx.toolClientMap`,
+ *        `ctx.externalTools`, `ctx.mainLlm`
+ * Writes: yields chunks via `ctx.yield()`, updates `ctx.timing`
+ *
+ * ## Config
+ *
+ * | Field              | Type   | Default     | Description                     |
+ * |--------------------|--------|-------------|---------------------------------|
+ * | `maxIterations`    | number | from ctx    | Max tool-loop iterations        |
+ * | `maxToolCalls`     | number | from ctx    | Max total tool calls per request|
+ * | `heartbeatIntervalMs` | number | 5000     | SSE heartbeat interval (ms)     |
+ *
+ * ## Includes
+ *
+ * - Output validation (re-prompts on invalid LLM output)
+ * - Tool call classification (internal / external / hallucinated / blocked)
+ * - Concurrent tool execution with heartbeat
+ * - Tool availability tracking (temporary blacklist)
+ */
+import { OrchestratorError } from '../../agent.js';
+import { isToolContextUnavailableError } from '../../policy/tool-availability-registry.js';
+import { getStreamToolCallName, toToolCallDelta, } from '../../utils/tool-call-deltas.js';
+export class ToolLoopHandler {
+    async execute(ctx, config, parentSpan) {
+        const maxIterations = config.maxIterations ?? ctx.config.maxIterations;
+        const maxToolCalls = config.maxToolCalls ?? ctx.config.maxToolCalls;
+        const heartbeatMs = config.heartbeatIntervalMs ??
+            ctx.config.heartbeatIntervalMs ??
+            5000;
+        const mode = ctx.config.mode || 'smart';
+        const externalTools = mode === 'hard' ? [] : ctx.externalTools;
+        const externalToolNames = new Set(externalTools.map((t) => t.name));
+        let toolCallCount = 0;
+        let messages = ctx.assembledMessages;
+        const usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+        const timingLog = [];
+        const loopStart = Date.now();
+        let currentTools = ctx.activeTools;
+        for (let iteration = 0;; iteration++) {
+            if (ctx.options?.signal?.aborted) {
+                ctx.yield({
+                    ok: false,
+                    error: new OrchestratorError('Aborted', 'ABORTED'),
+                });
+                return false;
+            }
+            if (iteration >= maxIterations) {
+                timingLog.push({ phase: 'total', duration: Date.now() - loopStart });
+                ctx.timing.push(...timingLog);
+                ctx.yield({
+                    ok: true,
+                    value: {
+                        content: '',
+                        finishReason: 'length',
+                        usage,
+                        timing: timingLog,
+                    },
+                });
+                return true;
+            }
+            // Filter tools per iteration
+            const filteredForIteration = ctx.toolAvailabilityRegistry.filterTools(ctx.sessionId, currentTools);
+            currentTools = filteredForIteration.allowed;
+            if (filteredForIteration.blocked.length > 0) {
+                ctx.options?.sessionLogger?.logStep('active_tools_filtered_in_iteration', { iteration: iteration + 1, blocked: filteredForIteration.blocked });
+            }
+            ctx.options?.sessionLogger?.logStep(`llm_request_iter_${iteration + 1}`, {
+                messages,
+                tools: currentTools,
+            });
+            const llmSpan = ctx.tracer.startSpan('smart_agent.llm_call', {
+                parent: parentSpan,
+                attributes: { 'llm.iteration': iteration + 1 },
+            });
+            ctx.metrics.llmCallCount.add();
+            const llmCallStart = Date.now();
+            const stream = ctx.mainLlm.streamChat(messages, currentTools, ctx.options);
+            let content = '';
+            let finishReason;
+            const toolCallsMap = new Map();
+            for await (const chunkResult of stream) {
+                if (!chunkResult.ok) {
+                    llmSpan.setStatus('error', chunkResult.error.message);
+                    llmSpan.end();
+                    ctx.yield({
+                        ok: false,
+                        error: new OrchestratorError(chunkResult.error.message, 'LLM_ERROR'),
+                    });
+                    return false;
+                }
+                const chunk = chunkResult.value;
+                if (chunk.content) {
+                    content += chunk.content;
+                    ctx.yield({ ok: true, value: { content: chunk.content } });
+                }
+                if (chunk.toolCalls) {
+                    const externalDeltas = chunk.toolCalls.filter((tc) => externalToolNames.has(getStreamToolCallName(tc) ?? ''));
+                    if (externalDeltas.length > 0) {
+                        ctx.yield({
+                            ok: true,
+                            value: { content: '', toolCalls: externalDeltas },
+                        });
+                    }
+                    for (const [fallbackIndex, rawToolCall,] of chunk.toolCalls.entries()) {
+                        const tc = toToolCallDelta(rawToolCall, fallbackIndex);
+                        if (!toolCallsMap.has(tc.index)) {
+                            toolCallsMap.set(tc.index, {
+                                id: tc.id || '',
+                                name: tc.name || '',
+                                arguments: tc.arguments || '',
+                            });
+                        }
+                        else {
+                            const ex = toolCallsMap.get(tc.index);
+                            if (ex) {
+                                if (tc.id)
+                                    ex.id = tc.id;
+                                if (tc.name)
+                                    ex.name = tc.name;
+                                if (tc.arguments)
+                                    ex.arguments += tc.arguments;
+                            }
+                        }
+                    }
+                }
+                if (chunk.finishReason)
+                    finishReason = chunk.finishReason;
+                if (chunk.usage) {
+                    usage.promptTokens += chunk.usage.promptTokens;
+                    usage.completionTokens += chunk.usage.completionTokens;
+                    usage.totalTokens += chunk.usage.totalTokens;
+                    ctx.sessionManager.addTokens(chunk.usage.totalTokens);
+                }
+            }
+            llmSpan.setStatus('ok');
+            llmSpan.end();
+            const llmCallDuration = Date.now() - llmCallStart;
+            ctx.metrics.llmCallLatency.record(llmCallDuration);
+            timingLog.push({
+                phase: `llm_call_${iteration + 1}`,
+                duration: llmCallDuration,
+            });
+            const toolCalls = Array.from(toolCallsMap.values()).map((tc) => {
+                let args = {};
+                try {
+                    args = JSON.parse(tc.arguments);
+                }
+                catch {
+                    args = {};
+                }
+                return { id: tc.id, name: tc.name, arguments: args };
+            });
+            ctx.options?.sessionLogger?.logStep(`llm_response_iter_${iteration + 1}`, { content, toolCalls, finishReason });
+            // -- No tool calls: validate and finish --------------------------------
+            if (finishReason !== 'tool_calls' || toolCalls.length === 0) {
+                const valResult = await ctx.outputValidator.validate(content, { messages, tools: currentTools }, ctx.options);
+                if (valResult.ok && !valResult.value.valid) {
+                    const correction = valResult.value.correctedContent ?? valResult.value.reason;
+                    messages = [
+                        ...messages,
+                        { role: 'assistant', content },
+                        {
+                            role: 'user',
+                            content: `Your previous response was rejected by validation: ${correction}. Please try again.`,
+                        },
+                    ];
+                    continue;
+                }
+                ctx.options?.sessionLogger?.logStep('final_response', {
+                    content,
+                    usage,
+                });
+                timingLog.push({ phase: 'total', duration: Date.now() - loopStart });
+                ctx.timing.push(...timingLog);
+                ctx.yield({
+                    ok: true,
+                    value: {
+                        content: '',
+                        finishReason: finishReason || 'stop',
+                        usage,
+                        timing: timingLog,
+                    },
+                });
+                return true;
+            }
+            // -- Classify tool calls -----------------------------------------------
+            const internalCalls = toolCalls.filter((tc) => ctx.toolClientMap.has(tc.name));
+            const validExternalCalls = toolCalls.filter((tc) => externalToolNames.has(tc.name));
+            const blockedToolNames = ctx.toolAvailabilityRegistry.getBlockedToolNames(ctx.sessionId);
+            const blockedCalls = toolCalls.filter((tc) => blockedToolNames.has(tc.name));
+            const hallucinations = toolCalls.filter((tc) => !blockedToolNames.has(tc.name) &&
+                !ctx.toolClientMap.has(tc.name) &&
+                !externalToolNames.has(tc.name));
+            // -- Handle blocked tools ----------------------------------------------
+            if (blockedCalls.length > 0) {
+                messages = [
+                    ...messages,
+                    {
+                        role: 'assistant',
+                        content: content || null,
+                        tool_calls: blockedCalls.map((tc) => ({
+                            id: tc.id,
+                            type: 'function',
+                            function: {
+                                name: tc.name,
+                                arguments: JSON.stringify(tc.arguments),
+                            },
+                        })),
+                    },
+                ];
+                for (const blocked of blockedCalls) {
+                    messages = [
+                        ...messages,
+                        {
+                            role: 'tool',
+                            content: `Error: Tool "${blocked.name}" is temporarily unavailable in this session.`,
+                            tool_call_id: blocked.id,
+                        },
+                    ];
+                }
+                ctx.options?.sessionLogger?.logStep('blocked_tool_calls_intercepted', {
+                    toolNames: blockedCalls.map((tc) => tc.name),
+                });
+                continue;
+            }
+            // -- Handle hallucinated tools -----------------------------------------
+            if (hallucinations.length > 0) {
+                messages = [
+                    ...messages,
+                    {
+                        role: 'assistant',
+                        content: content || null,
+                        tool_calls: toolCalls.map((tc) => ({
+                            id: tc.id,
+                            type: 'function',
+                            function: {
+                                name: tc.name,
+                                arguments: JSON.stringify(tc.arguments),
+                            },
+                        })),
+                    },
+                ];
+                for (const h of hallucinations) {
+                    messages = [
+                        ...messages,
+                        {
+                            role: 'tool',
+                            content: `Error: Tool "${h.name}" not found.`,
+                            tool_call_id: h.id,
+                        },
+                    ];
+                }
+                continue;
+            }
+            // -- Handle external tool calls (delegate to consumer) -----------------
+            if (validExternalCalls.length > 0) {
+                timingLog.push({ phase: 'total', duration: Date.now() - loopStart });
+                ctx.timing.push(...timingLog);
+                ctx.yield({
+                    ok: true,
+                    value: {
+                        content: '',
+                        finishReason: 'tool_calls',
+                        usage,
+                        timing: timingLog,
+                    },
+                });
+                return true;
+            }
+            // -- Execute internal MCP tool calls -----------------------------------
+            if (content || internalCalls.length > 0) {
+                messages = [
+                    ...messages,
+                    {
+                        role: 'assistant',
+                        content: content || null,
+                        tool_calls: internalCalls.map((tc) => ({
+                            id: tc.id,
+                            type: 'function',
+                            function: {
+                                name: tc.name,
+                                arguments: JSON.stringify(tc.arguments),
+                            },
+                        })),
+                    },
+                ];
+            }
+            // Check tool call budget
+            const remaining = maxToolCalls !== undefined
+                ? maxToolCalls - toolCallCount
+                : internalCalls.length;
+            if (remaining <= 0) {
+                timingLog.push({ phase: 'total', duration: Date.now() - loopStart });
+                ctx.timing.push(...timingLog);
+                ctx.yield({
+                    ok: true,
+                    value: {
+                        content: '',
+                        finishReason: 'length',
+                        usage,
+                        timing: timingLog,
+                    },
+                });
+                return true;
+            }
+            const batch = internalCalls.slice(0, remaining);
+            // Yield progress messages
+            for (const tc of batch) {
+                ctx.yield({
+                    ok: true,
+                    value: { content: `\n\n[SmartAgent: Executing ${tc.name}...]\n` },
+                });
+            }
+            const toolExecPromises = batch.map(async (tc) => {
+                const toolStart = Date.now();
+                ctx.options?.sessionLogger?.logStep(`mcp_call_${tc.name}`, {
+                    arguments: tc.arguments,
+                });
+                const client = ctx.toolClientMap.get(tc.name);
+                if (!client)
+                    return { tc, text: '', res: null, duration: 0 };
+                const toolSpan = ctx.tracer.startSpan('smart_agent.tool_call', {
+                    parent: parentSpan,
+                    attributes: { 'tool.name': tc.name },
+                });
+                const cached = ctx.toolCache.get(tc.name, tc.arguments);
+                const res = cached
+                    ? (() => {
+                        ctx.metrics.toolCacheHitCount.add();
+                        toolSpan.setAttribute('cache', 'hit');
+                        return { ok: true, value: cached };
+                    })()
+                    : await (async () => {
+                        const r = await client.callTool(tc.name, tc.arguments, ctx.options);
+                        if (r.ok)
+                            ctx.toolCache.set(tc.name, tc.arguments, r.value);
+                        return r;
+                    })();
+                const text = !res.ok
+                    ? res.error.message
+                    : typeof res.value.content === 'string'
+                        ? res.value.content
+                        : JSON.stringify(res.value.content);
+                toolSpan.setStatus(res.ok ? 'ok' : 'error', res.ok ? undefined : text);
+                toolSpan.end();
+                return { tc, text, res, duration: Date.now() - toolStart };
+            });
+            // Race: tool execution vs periodic heartbeat
+            const allDone = Promise.all(toolExecPromises);
+            const pendingTools = new Set(batch.map((tc) => tc.name));
+            const toolStartTime = Date.now();
+            let results = [];
+            let settled = false;
+            for (const [i, p] of toolExecPromises.entries()) {
+                p.then(() => pendingTools.delete(batch[i].name));
+            }
+            while (!settled) {
+                const winner = await Promise.race([
+                    allDone.then((r) => ({ tag: 'done', results: r })),
+                    new Promise((resolve) => setTimeout(() => resolve({ tag: 'tick' }), heartbeatMs)),
+                ]);
+                if (winner.tag === 'done') {
+                    results = winner.results;
+                    settled = true;
+                }
+                else {
+                    for (const tool of pendingTools) {
+                        ctx.yield({
+                            ok: true,
+                            value: {
+                                content: '',
+                                heartbeat: { tool, elapsed: Date.now() - toolStartTime },
+                            },
+                        });
+                    }
+                }
+            }
+            // Collect timing
+            for (const r of results) {
+                timingLog.push({ phase: `tool_${r.tc.name}`, duration: r.duration });
+            }
+            // Process results
+            const toolMessages = [];
+            for (const { tc, text, res } of results) {
+                if (!res)
+                    continue;
+                if (!res.ok && isToolContextUnavailableError(text)) {
+                    const entry = ctx.toolAvailabilityRegistry.block(ctx.sessionId, tc.name, text);
+                    currentTools = currentTools.filter((t) => t.name !== tc.name);
+                    ctx.options?.sessionLogger?.logStep(`tool_blacklisted_${tc.name}`, {
+                        reason: text,
+                        blockedUntil: entry.blockedUntil,
+                    });
+                }
+                ctx.options?.sessionLogger?.logStep(`mcp_result_${tc.name}`, {
+                    result: text,
+                });
+                toolCallCount++;
+                ctx.metrics.toolCallCount.add();
+                toolMessages.push({
+                    role: 'tool',
+                    content: text,
+                    tool_call_id: tc.id,
+                });
+            }
+            messages = [...messages, ...toolMessages];
+        }
+    }
+}
+//# sourceMappingURL=tool-loop.js.map

package/dist/smart-agent/pipeline/handlers/tool-loop.js.map

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

package/dist/smart-agent/pipeline/handlers/tool-select.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ToolSelectHandler — selects MCP tools based on RAG results.
+ *
+ * Reads: `ctx.ragResults.facts`, `ctx.mcpTools`, `ctx.externalTools`, `ctx.toolClientMap`
+ * Writes: `ctx.selectedTools`, `ctx.activeTools`
+ *
+ * Uses RAG fact IDs with the `tool:` prefix to identify relevant MCP tools.
+ *
+ * If RAG retrieval was skipped (e.g. `shouldRetrieve` was false), the handler
+ * performs its own facts RAG query to discover tools. This ensures tools are
+ * always discoverable regardless of domain context detection.
+ *
+ * Falls back to all MCP tools in `hard` mode or external-only in `smart` mode.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class ToolSelectHandler implements IStageHandler {
+    execute(ctx: PipelineContext, config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=tool-select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-select.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/tool-select.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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,iBAAkB,YAAW,aAAa;IAC/C,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,OAAO,CAAC;CAmGpB"}

package/dist/smart-agent/pipeline/handlers/tool-select.js

@@ -0,0 +1,95 @@
+/**
+ * ToolSelectHandler — selects MCP tools based on RAG results.
+ *
+ * Reads: `ctx.ragResults.facts`, `ctx.mcpTools`, `ctx.externalTools`, `ctx.toolClientMap`
+ * Writes: `ctx.selectedTools`, `ctx.activeTools`
+ *
+ * Uses RAG fact IDs with the `tool:` prefix to identify relevant MCP tools.
+ *
+ * If RAG retrieval was skipped (e.g. `shouldRetrieve` was false), the handler
+ * performs its own facts RAG query to discover tools. This ensures tools are
+ * always discoverable regardless of domain context detection.
+ *
+ * Falls back to all MCP tools in `hard` mode or external-only in `smart` mode.
+ */
+export class ToolSelectHandler {
+    async execute(ctx, config, span) {
+        const mode = ctx.config.mode || 'smart';
+        // List all MCP tools if not already done
+        if (ctx.mcpTools.length === 0 && ctx.mcpClients.length > 0) {
+            const settled = await Promise.allSettled(ctx.mcpClients.map(async (client) => ({
+                client,
+                result: await client.listTools(ctx.options),
+            })));
+            for (const entry of settled) {
+                if (entry.status === 'fulfilled' && entry.value.result.ok) {
+                    for (const t of entry.value.result.value) {
+                        if (!ctx.toolClientMap.has(t.name)) {
+                            ctx.mcpTools.push(t);
+                            ctx.toolClientMap.set(t.name, entry.value.client);
+                        }
+                    }
+                }
+            }
+        }
+        // If RAG retrieval was skipped, query facts store directly for tool discovery.
+        // Tools should always be discoverable regardless of shouldRetrieve flag.
+        let factsResults = ctx.ragResults.facts;
+        if (factsResults.length === 0 && ctx.mcpTools.length > 0) {
+            const k = config.k ?? ctx.config.ragQueryK ?? 20;
+            const queryText = ctx.ragText || ctx.inputText;
+            const result = await ctx.ragStores.facts.query(queryText, k, ctx.options);
+            if (result.ok) {
+                factsResults = result.value;
+                // Also populate ctx.ragResults.facts so assemble can use them
+                ctx.ragResults.facts = result.value;
+                ctx.options?.sessionLogger?.logStep('tool_select_rag_fallback', {
+                    reason: 'RAG retrieval was skipped, querying facts for tool discovery',
+                    query: queryText.slice(0, 200),
+                    k,
+                    resultCount: result.value.length,
+                    results: result.value.map((r) => ({
+                        id: r.metadata.id,
+                        score: r.score,
+                        text: r.text.slice(0, 120),
+                    })),
+                });
+            }
+        }
+        // Select tools based on RAG results
+        const ragToolNames = new Set(factsResults
+            .map((r) => r.metadata.id)
+            .filter((id) => id?.startsWith('tool:'))
+            .map((id) => id.slice(5)));
+        const selectedMcpTools = ragToolNames.size > 0
+            ? ctx.mcpTools.filter((t) => ragToolNames.has(t.name))
+            : mode === 'hard'
+                ? ctx.mcpTools
+                : [];
+        ctx.selectedTools =
+            mode === 'hard'
+                ? selectedMcpTools
+                : [...selectedMcpTools, ...ctx.externalTools];
+        // Apply availability filtering
+        const filtered = ctx.toolAvailabilityRegistry.filterTools(ctx.sessionId, ctx.selectedTools);
+        ctx.activeTools = filtered.allowed;
+        if (filtered.blocked.length > 0) {
+            ctx.options?.sessionLogger?.logStep('active_tools_filtered_by_registry', {
+                blocked: filtered.blocked,
+            });
+        }
+        span.setAttribute('mcp_tools', ctx.mcpTools.length);
+        span.setAttribute('selected', ctx.selectedTools.length);
+        span.setAttribute('active', ctx.activeTools.length);
+        // Log tool selection diagnostics
+        ctx.options?.sessionLogger?.logStep('tools_selected', {
+            totalMcp: ctx.mcpTools.length,
+            ragMatchedTools: [...ragToolNames],
+            selectedCount: ctx.selectedTools.length,
+            selectedNames: ctx.selectedTools.map((t) => t.name),
+            activeCount: ctx.activeTools.length,
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=tool-select.js.map

package/dist/smart-agent/pipeline/handlers/tool-select.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * TranslateHandler — translates non-ASCII RAG query text to English.
+ *
+ * Reads: `ctx.ragText`, `ctx.helperLlm` (or `ctx.mainLlm` as fallback)
+ * Writes: `ctx.ragText`
+ *
+ * Skips translation when:
+ * - `ragTranslationEnabled` is false
+ * - Text is ASCII-only
+ * - Text is shorter than 15 characters
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class TranslateHandler implements IStageHandler {
+    execute(ctx: PipelineContext, _config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=translate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;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,gBAAiB,YAAW,aAAa;IAC9C,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,OAAO,CAAC;CAoCpB"}

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

@@ -0,0 +1,39 @@
+/**
+ * TranslateHandler — translates non-ASCII RAG query text to English.
+ *
+ * Reads: `ctx.ragText`, `ctx.helperLlm` (or `ctx.mainLlm` as fallback)
+ * Writes: `ctx.ragText`
+ *
+ * Skips translation when:
+ * - `ragTranslationEnabled` is false
+ * - Text is ASCII-only
+ * - Text is shorter than 15 characters
+ */
+export class TranslateHandler {
+    async execute(ctx, _config, span) {
+        if (ctx.config.ragTranslationEnabled === false) {
+            span.setAttribute('skipped', true);
+            span.setAttribute('reason', 'disabled');
+            return true;
+        }
+        ctx.isAscii = /^[\p{ASCII}]+$/u.test(ctx.ragText);
+        if (ctx.isAscii || ctx.ragText.length < 15) {
+            span.setAttribute('skipped', true);
+            span.setAttribute('reason', ctx.isAscii ? 'ascii' : 'too_short');
+            return true;
+        }
+        const prompt = ctx.config.ragTranslatePrompt ??
+            'Translate the user request to English for search purposes. Preserve technical terms if present. Reply with only the expanded English terms, no explanation.';
+        const llm = ctx.helperLlm || ctx.mainLlm;
+        const res = await llm.chat([
+            { role: 'system', content: prompt },
+            { role: 'user', content: ctx.ragText },
+        ], [], ctx.options);
+        if (res.ok && res.value.content.trim()) {
+            ctx.ragText = res.value.content.trim();
+            span.setAttribute('translated', true);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=translate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../../../src/smart-agent/pipeline/handlers/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,OAAgC,EAChC,IAAW;QAEX,IAAI,GAAG,CAAC,MAAM,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,GAAG,CAAC,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAElD,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,kBAAkB;YAC7B,6JAA6J,CAAC;QAEhK,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CACxB;YACE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,MAAM,EAAE;YAC5C,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;SAChD,EACD,EAAE,EACF,GAAG,CAAC,OAAO,CACZ,CAAC;QAEF,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+/**
+ * Structured pipeline — public API.
+ *
+ * Exports the pipeline DSL types, executor, context, condition evaluator,
+ * default pipeline definition, and all built-in stage handlers.
+ */
+export { evaluateCondition } from './condition-evaluator.js';
+export type { PipelineContext } from './context.js';
+export { getDefaultPipelineDefinition, getDefaultStages, } from './default-pipeline.js';
+export { PipelineExecutor } from './executor.js';
+export { AssembleHandler, buildDefaultHandlerRegistry, ClassifyHandler, ExpandHandler, RagQueryHandler, RagUpsertHandler, RerankHandler, type StageHandlerRegistry, SummarizeHandler, ToolLoopHandler, ToolSelectHandler, TranslateHandler, } from './handlers/index.js';
+export type { IStageHandler } from './stage-handler.js';
+export type { BuiltInStageType, ControlFlowType, StageDefinition, StageType, StructuredPipelineDefinition, } from './types.js';
+//# sourceMappingURL=index.d.ts.map