@mcp-abap-adt/llm-agent-libs 12.0.2 → 12.0.3

package/dist/pipeline/handlers/rerank.js

@@ -0,0 +1,27 @@
+/**
+ * RerankHandler — re-scores RAG results using the injected reranker.
+ *
+ * Reads: `ctx.ragText`, `ctx.ragResults`
+ * Writes: `ctx.ragResults` (replaces with re-scored versions)
+ *
+ * Runs reranking on all stores in parallel. Falls back to original
+ * results if reranking fails for a store.
+ */
+export class RerankHandler {
+    async execute(ctx, _config, span) {
+        const entries = Object.entries(ctx.ragResults);
+        const reranked = await Promise.all(entries.map(async ([name, results]) => {
+            if (results.length > 0) {
+                const rr = await ctx.reranker.rerank(ctx.ragText, results, ctx.options);
+                return { name, results: rr.ok ? rr.value : results };
+            }
+            return { name, results };
+        }));
+        for (const { name, results } of reranked) {
+            ctx.ragResults[name] = results;
+            span.setAttribute(name, results.length);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=rerank.js.map

package/dist/pipeline/handlers/rerank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.js","sourceRoot":"","sources":["../../../src/pipeline/handlers/rerank.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,OAAgC,EAChC,IAAW;QAEX,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;YACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAClC,GAAG,CAAC,OAAO,EACX,OAAO,EACP,GAAG,CAAC,OAAO,CACZ,CAAC;gBACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B,CAAC,CAAC,CACH,CAAC;QAEF,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;YACzC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;YAC/B,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/pipeline/handlers/skill-select.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SkillSelectHandler — selects skills based on RAG results and loads their content.
+ *
+ * Reads: `ctx.skillManager`, `ctx.ragResults.facts`, `ctx.config.mode`, `ctx.inputText`
+ * Writes: `ctx.selectedSkills`, `ctx.skillContent`
+ *
+ * Uses RAG fact IDs with the `skill:` prefix to identify relevant skills.
+ * Falls back to all skills in `hard` mode, none otherwise.
+ *
+ * If no `ctx.skillManager` is configured, this handler is a no-op.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class SkillSelectHandler implements IStageHandler {
+    execute(ctx: PipelineContext, _config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=skill-select.d.ts.map

package/dist/pipeline/handlers/skill-select.d.ts.map

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

package/dist/pipeline/handlers/skill-select.js

@@ -0,0 +1,88 @@
+/**
+ * SkillSelectHandler — selects skills based on RAG results and loads their content.
+ *
+ * Reads: `ctx.skillManager`, `ctx.ragResults.facts`, `ctx.config.mode`, `ctx.inputText`
+ * Writes: `ctx.selectedSkills`, `ctx.skillContent`
+ *
+ * Uses RAG fact IDs with the `skill:` prefix to identify relevant skills.
+ * Falls back to all skills in `hard` mode, none otherwise.
+ *
+ * If no `ctx.skillManager` is configured, this handler is a no-op.
+ */
+import { QueryEmbedding, TextOnlyEmbedding } from '@mcp-abap-adt/llm-agent';
+export class SkillSelectHandler {
+    async execute(ctx, _config, span) {
+        if (!ctx.skillManager) {
+            span.setAttribute('skipped', true);
+            return true;
+        }
+        const mode = ctx.config.mode || 'smart';
+        // Discover skills from all RAG results
+        const allRagResults = Object.values(ctx.ragResults).flat();
+        const ragSkillNames = new Set(allRagResults
+            .map((r) => r.metadata.id)
+            .filter((id) => id?.startsWith('skill:'))
+            .map((id) => id.slice(6)));
+        // If no skill:* entries in RAG results, do a dedicated query on all stores.
+        if (ragSkillNames.size === 0) {
+            const k = _config.k ?? ctx.config.ragQueryK ?? 15;
+            const queryText = ctx.ragText || ctx.inputText;
+            const storeEntries = Object.entries(ctx.ragStores);
+            const embedding = ctx.embedder
+                ? new QueryEmbedding(queryText, ctx.embedder, ctx.options)
+                : new TextOnlyEmbedding(queryText);
+            const queryResults = await Promise.all(storeEntries.map(([, store]) => store.query(embedding, k, ctx.options)));
+            for (const result of queryResults) {
+                if (result.ok) {
+                    for (const r of result.value) {
+                        const id = r.metadata.id;
+                        if (id?.startsWith('skill:')) {
+                            ragSkillNames.add(id.slice(6));
+                        }
+                    }
+                }
+            }
+            if (ragSkillNames.size > 0) {
+                ctx.options?.sessionLogger?.logStep('skill_select_rag_fallback', {
+                    query: queryText.slice(0, 200),
+                    k,
+                    matchedSkills: [...ragSkillNames],
+                });
+            }
+        }
+        const allSkillsResult = await ctx.skillManager.listSkills(ctx.options);
+        if (!allSkillsResult.ok) {
+            ctx.options?.sessionLogger?.logStep('skill_select_error', {
+                error: allSkillsResult.error.message,
+            });
+            return true; // Non-fatal — continue without skills
+        }
+        const allSkills = allSkillsResult.value;
+        // Select skills based on RAG matches or fallback
+        ctx.selectedSkills =
+            ragSkillNames.size > 0
+                ? allSkills.filter((s) => ragSkillNames.has(s.name))
+                : mode === 'hard'
+                    ? allSkills
+                    : [];
+        // Load content for selected skills
+        const contentParts = [];
+        for (const skill of ctx.selectedSkills) {
+            const contentResult = await skill.getContent(ctx.skillArgs || undefined, ctx.options);
+            if (contentResult.ok && contentResult.value) {
+                contentParts.push(`### Skill: ${skill.name}\n${contentResult.value}`);
+            }
+        }
+        ctx.skillContent = contentParts.join('\n\n');
+        span.setAttribute('total_skills', allSkills.length);
+        span.setAttribute('selected_skills', ctx.selectedSkills.length);
+        ctx.options?.sessionLogger?.logStep('skills_selected', {
+            totalSkills: allSkills.length,
+            ragMatchedSkills: [...ragSkillNames],
+            selectedCount: ctx.selectedSkills.length,
+            selectedNames: ctx.selectedSkills.map((s) => s.name),
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=skill-select.js.map

package/dist/pipeline/handlers/skill-select.js.map

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

package/dist/pipeline/handlers/summarize.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SummarizeHandler — condenses conversation history using helper LLM.
+ *
+ * Reads: `ctx.history`, `ctx.helperLlm`
+ * Writes: `ctx.history` (replaces with summarized version)
+ *
+ * Keeps the last 5 messages verbatim and summarizes the rest into a
+ * single system message. Skips silently if no helper LLM is available
+ * or history is too short.
+ */
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class SummarizeHandler implements IStageHandler {
+    execute(ctx: PipelineContext, config: Record<string, unknown>, span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=summarize.d.ts.map

package/dist/pipeline/handlers/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;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,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,OAAO,CAAC;CAwDpB"}

package/dist/pipeline/handlers/summarize.js

@@ -0,0 +1,56 @@
+/**
+ * SummarizeHandler — condenses conversation history using helper LLM.
+ *
+ * Reads: `ctx.history`, `ctx.helperLlm`
+ * Writes: `ctx.history` (replaces with summarized version)
+ *
+ * Keeps the last 5 messages verbatim and summarizes the rest into a
+ * single system message. Skips silently if no helper LLM is available
+ * or history is too short.
+ */
+export class SummarizeHandler {
+    async execute(ctx, config, span) {
+        if (!ctx.helperLlm) {
+            span.setAttribute('skipped', true);
+            span.setAttribute('reason', 'no_helper_llm');
+            return true;
+        }
+        const limit = config.limit ?? ctx.config.historyAutoSummarizeLimit ?? 10;
+        if (ctx.history.length <= limit) {
+            span.setAttribute('skipped', true);
+            span.setAttribute('reason', 'history_under_limit');
+            return true;
+        }
+        const toSummarize = ctx.history.slice(0, -5);
+        const recent = ctx.history.slice(-5);
+        if (toSummarize.length === 0)
+            return true;
+        const prompt = ctx.config.historySummaryPrompt ??
+            'Summarize the conversation so far in 2-3 sentences. Focus on the user goals and the current status of the task. Keep technical SAP terms as is.';
+        const chatStart = Date.now();
+        const res = await ctx.helperLlm.chat([...toSummarize, { role: 'system', content: prompt }], [], ctx.options);
+        ctx.requestLogger.logLlmCall({
+            component: 'helper',
+            model: ctx.helperLlm.model ?? 'unknown',
+            promptTokens: res.ok ? (res.value.usage?.promptTokens ?? 0) : 0,
+            completionTokens: res.ok ? (res.value.usage?.completionTokens ?? 0) : 0,
+            totalTokens: res.ok ? (res.value.usage?.totalTokens ?? 0) : 0,
+            durationMs: Date.now() - chatStart,
+        });
+        if (!res.ok) {
+            // Non-fatal — keep original history
+            span.setAttribute('fallback', true);
+            return true;
+        }
+        ctx.history = [
+            {
+                role: 'system',
+                content: `Summary of previous conversation: ${res.value.content}`,
+            },
+            ...recent,
+        ];
+        span.setAttribute('summarized_count', toSummarize.length);
+        return true;
+    }
+}
+//# sourceMappingURL=summarize.js.map

package/dist/pipeline/handlers/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../src/pipeline/handlers/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,MAA+B,EAC/B,IAAW;QAEX,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GACR,MAAM,CAAC,KAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,yBAAyB,IAAI,EAAE,CAAC;QAEzE,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,oBAAoB;YAC/B,iJAAiJ,CAAC;QAEpJ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAClC,CAAC,GAAG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAC9D,EAAE,EACF,GAAG,CAAC,OAAO,CACZ,CAAC;QACF,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC;YAC3B,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,SAAS;YACvC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,oCAAoC;YACpC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,GAAG,CAAC,OAAO,GAAG;YACZ;gBACE,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,qCAAqC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;aAClE;YACD,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/pipeline/handlers/tool-loop.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class ToolLoopHandler implements IStageHandler {
+    execute(ctx: PipelineContext, config: Record<string, unknown>, parentSpan: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=tool-loop.d.ts.map

package/dist/pipeline/handlers/tool-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/tool-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAgBH,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;AAqDzD,qBAAa,eAAgB,YAAW,aAAa;IAC7C,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,KAAK,GAChB,OAAO,CAAC,OAAO,CAAC;CAyxBpB"}