@mcp-abap-adt/llm-agent-server 16.2.0 → 17.0.0

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "16.2.0";
+export declare const PACKAGE_VERSION = "17.0.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.js — do not edit
-export const PACKAGE_VERSION = '16.2.0';
+export const PACKAGE_VERSION = '17.0.0';
 //# sourceMappingURL=version.js.map

package/dist/smart-agent/build-dag-coordinator-deps.d.ts

@@ -0,0 +1,34 @@
+import type { ILlm, ISubAgent } from '@mcp-abap-adt/llm-agent';
+import type { DagCoordinatorHandlerDeps } from '@mcp-abap-adt/llm-agent-libs';
+import { type NormalizedLlmMap } from './config.js';
+import type { SmartServerLlmConfig } from './smart-server.js';
+export interface BuildDagCoordinatorDepsInput {
+    coordCfg: Record<string, unknown> | undefined;
+    llmMap: NormalizedLlmMap | undefined;
+    /** Adapted from `pipeline.llm.main` (already shape-normalized to
+     *  SmartServerLlmConfig: `{ provider, apiKey, url: baseURL, model,
+     *  temperature }`). When set, used as the final fallback in the
+     *  role-resolution chain map[name] → map.main → pipelineFallback. */
+    pipelineFallback: SmartServerLlmConfig | undefined;
+    mainLlm: ILlm;
+    helperLlm: ILlm | undefined;
+    mainTemp: number;
+    registry: ReadonlyMap<string, ISubAgent>;
+    makeLlm: (config: SmartServerLlmConfig) => Promise<ILlm>;
+    warn: (msg: string) => void;
+}
+export type BuiltDagCoordinatorDeps = Omit<DagCoordinatorHandlerDeps, 'workers'> & {
+    workers: Map<string, ISubAgent>;
+    oracleName?: string;
+};
+/**
+ * Assemble the full deps record for `withDagCoordinator`. Returns
+ * `undefined` when the YAML does not declare a DAG coordinator (no
+ * `planner` block), so the caller can branch.
+ *
+ * Roles resolve their LLM via the chain:
+ *   resolveLlmConfig(llmMap, name, pipelineFallback)
+ *   → top-level llm.<name> → llm.main → pipelineFallback (pipeline.llm.main)
+ */
+export declare function buildDagCoordinatorDeps(input: BuildDagCoordinatorDepsInput): Promise<BuiltDagCoordinatorDeps | undefined>;
+//# sourceMappingURL=build-dag-coordinator-deps.d.ts.map

package/dist/smart-agent/build-dag-coordinator-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-dag-coordinator-deps.d.ts","sourceRoot":"","sources":["../../src/smart-agent/build-dag-coordinator-deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,IAAI,EAEJ,SAAS,EACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAS9E,OAAO,EAEL,KAAK,gBAAgB,EAKtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC;;;yEAGqE;IACrE,gBAAgB,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACnD,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,yBAAyB,EACzB,SAAS,CACV,GAAG;IACF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CA0I9C"}

package/dist/smart-agent/build-dag-coordinator-deps.js

@@ -0,0 +1,107 @@
+import { AbortErrorStrategy, DagPlanInterpreter, LlmDagPlanner, LlmReviewStrategy, ReplanErrorStrategy, SubAgentStateOracle, } from '@mcp-abap-adt/llm-agent-libs';
+import { buildFinalizer, resolveCoordinatorActivation, resolveLlmConfig, resolveLlmConfigStrict, resolveReviewerLlmName, } from './config.js';
+/**
+ * Assemble the full deps record for `withDagCoordinator`. Returns
+ * `undefined` when the YAML does not declare a DAG coordinator (no
+ * `planner` block), so the caller can branch.
+ *
+ * Roles resolve their LLM via the chain:
+ *   resolveLlmConfig(llmMap, name, pipelineFallback)
+ *   → top-level llm.<name> → llm.main → pipelineFallback (pipeline.llm.main)
+ */
+export async function buildDagCoordinatorDeps(input) {
+    const { coordCfg, llmMap, pipelineFallback, mainLlm, helperLlm, mainTemp, registry, makeLlm, warn, } = input;
+    if (!coordCfg || coordCfg.planner === undefined)
+        return undefined;
+    // ---- Role LLM resolver -----------------------------------------------
+    // Priority chain:
+    //   1. map[name] — explicit named entry in the top-level llm: block
+    //   2. 'helper' | 'planner' alias — route to the prebuilt helperLlm
+    //   3. pipelineFallback (pipeline.llm.main) — last resort
+    //   4. fallbackPrebuilt (mainLlm) — when nothing else resolves
+    const resolveRoleLlm = async (name, fallbackPrebuilt = mainLlm) => {
+        // 1. Explicit map[name] — use it (strict: no main fallback here).
+        const strict = resolveLlmConfigStrict(llmMap, name);
+        if (strict) {
+            return makeLlm({
+                ...strict,
+                temperature: Number(strict.temperature ?? mainTemp),
+            });
+        }
+        // 2. 'helper' | 'planner' alias → reuse prebuilt helperLlm.
+        if (name === 'helper' || name === 'planner') {
+            return helperLlm ?? fallbackPrebuilt;
+        }
+        // 3. Unknown name → final fallback chain via resolveLlmConfig (map.main → pipelineFallback).
+        if (name) {
+            const fb = resolveLlmConfig(llmMap, name, pipelineFallback);
+            if (fb) {
+                return makeLlm({
+                    ...fb,
+                    temperature: Number(fb.temperature ?? mainTemp),
+                });
+            }
+        }
+        // 4. No name at all → fallbackPrebuilt (mainLlm by default).
+        return fallbackPrebuilt;
+    };
+    // ---- Planner ----------------------------------------------------------
+    const plannerBlock = coordCfg.planner;
+    const plannerLlm = await resolveRoleLlm(plannerBlock?.plannerLlm);
+    const planner = new LlmDagPlanner(plannerLlm);
+    // ---- Reviewer (optional) ---------------------------------------------
+    let reviewer;
+    if (coordCfg.reviewer !== undefined) {
+        const reviewerBlock = coordCfg.reviewer;
+        const reviewerName = resolveReviewerLlmName(reviewerBlock, warn);
+        const reviewerLlm = await resolveRoleLlm(reviewerName);
+        reviewer = new LlmReviewStrategy(reviewerLlm);
+    }
+    // ---- Interpreter, workers, oracle, activation, error strategy --------
+    const interpreter = new DagPlanInterpreter();
+    const oracleName = coordCfg.stateOracle;
+    let rawOracle;
+    if (oracleName) {
+        rawOracle = registry.get(oracleName);
+        if (!rawOracle) {
+            throw new Error(`coordinator.stateOracle '${oracleName}' is not a declared subagent`);
+        }
+    }
+    const workers = new Map([...registry].filter(([name]) => name !== oracleName));
+    if (workers.size === 0) {
+        throw new Error('coordinator.planner is set (DAG mode) but no workers are configured. ' +
+            'Add at least one entry under the top-level `subagents:` block.');
+    }
+    const activation = resolveCoordinatorActivation((coordCfg.activation ?? 'explicit'));
+    let errorStrategy;
+    const esCfg = coordCfg.errorStrategy;
+    if (esCfg?.type === 'replan') {
+        errorStrategy = new ReplanErrorStrategy(planner, esCfg.maxReplans);
+    }
+    else if (esCfg?.type === 'abort') {
+        errorStrategy = new AbortErrorStrategy();
+    }
+    // ---- Finalizer --------------------------------------------------------
+    const finalizer = await buildFinalizer(coordCfg.finalizer, llmMap, pipelineFallback, async (lc) => makeLlm({
+        ...lc,
+        temperature: Number(lc.temperature ?? mainTemp),
+    }));
+    // ---- Oracle wrap ------------------------------------------------------
+    const stateOracle = rawOracle
+        ? new SubAgentStateOracle(rawOracle)
+        : undefined;
+    void mainLlm;
+    return {
+        planner,
+        interpreter,
+        workers,
+        activation,
+        reviewer,
+        errorStrategy,
+        stateOracle,
+        finalizer,
+        maxRoundTrips: coordCfg.maxRoundTrips,
+        oracleName,
+    };
+}
+//# sourceMappingURL=build-dag-coordinator-deps.js.map

package/dist/smart-agent/build-dag-coordinator-deps.js.map

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

package/dist/smart-agent/config.d.ts

@@ -1,9 +1,45 @@
 /**
  * Shared config utilities for SmartServer.
  */
-import type { ILlm, ISubAgentContextBuilder, IToolSelectionStrategy } from '@mcp-abap-adt/llm-agent';
+import type { IFinalizer, ILlm, ISubAgentContextBuilder, IToolSelectionStrategy } from '@mcp-abap-adt/llm-agent';
 import { AutoActivation, ExplicitActivation, HybridDispatch, OneShotPlanning, ReplanOnErrorPlanning, SelfDispatch, SkillStepsPlanning, SubAgentDispatch } from '@mcp-abap-adt/llm-agent-libs';
-import type { SmartServerConfig } from './smart-server.js';
+import type { SmartServerConfig, SmartServerLlmConfig } from './smart-server.js';
+export type LlmConfigMap = Record<string, SmartServerLlmConfig>;
+export type NormalizedLlmMap = {
+    main: SmartServerLlmConfig;
+} & LlmConfigMap;
+/**
+ * Normalize the optional top-level `llm:` block.
+ * - undefined → undefined (pipeline-only configs stay valid)
+ * - flat shape (has `provider` | `apiKey` | `model` | `url`) → { main: flat } (backward compat)
+ * - map shape → must include `main`; returned as NormalizedLlmMap
+ */
+export declare function normalizeLlmConfig(input?: SmartServerLlmConfig | LlmConfigMap): NormalizedLlmMap | undefined;
+/**
+ * Strict lookup: returns map[name] if explicitly present, else undefined.
+ * Does NOT fall through to map.main. Use when the caller needs to
+ * detect explicit-presence (e.g. to decide between an alias and the
+ * named map entry).
+ */
+export declare function resolveLlmConfigStrict(map: NormalizedLlmMap | undefined, name: string | undefined): SmartServerLlmConfig | undefined;
+/**
+ * Resolve a per-role LLM config by name from a normalized map.
+ * Lookup chain: map[name] → map.main → pipelineFallback.
+ * When map is undefined, falls back to pipelineFallback (so pipeline-only
+ * configs keep working with no top-level llm: block).
+ *
+ * The caller decides whether `undefined` is an error.
+ */
+export declare function resolveLlmConfig(map: NormalizedLlmMap | undefined, name?: string, pipelineFallback?: SmartServerLlmConfig): SmartServerLlmConfig | undefined;
+/**
+ * Read the reviewer block's LLM-name selector, accepting both the
+ * preferred `reviewerLlm` field and the deprecated `plannerLlm` alias.
+ * When the alias is used, calls `warn(message)`.
+ */
+export declare function resolveReviewerLlmName(block: {
+    reviewerLlm?: string;
+    plannerLlm?: string;
+} | undefined, warn: (msg: string) => void): string | undefined;
 export interface YamlCoordinator {
     planning?: 'one-shot' | 'replan-on-error' | 'skill-steps';
     dispatch?: 'subagent' | 'self' | 'hybrid';
@@ -13,8 +49,41 @@ export interface YamlCoordinator {
     maxRetriesPerStep?: number;
     failPolicy?: 'abort' | 'continue';
     maxLayer?: number;
+    planner?: {
+        type?: string;
+        plannerLlm?: 'main' | 'planner' | 'helper';
+    } | Record<string, unknown>;
+    interpreter?: {
+        type?: string;
+    } | Record<string, unknown>;
+    reviewer?: {
+        type?: string;
+        reviewerLlm?: string;
+        plannerLlm?: 'main' | 'planner' | 'helper';
+    };
+    finalizer?: {
+        type?: 'passthrough' | 'llm' | 'template';
+        finalizerLlm?: string;
+        systemPrompt?: string;
+    };
+    errorStrategy?: {
+        type?: string;
+        maxReplans?: number;
+    };
+    stateOracle?: string;
+    maxRoundTrips?: number;
 }
+/** Fail-loud guard: a coordinator block is either DAG (has `planner`) or linear,
+ *  never mixed. `activation` is shared and always allowed. */
+export declare function assertCoordinatorConfigShape(coord: Record<string, unknown>): void;
 export declare function resolveCoordinatorPlanning(name: string, plannerLlm: ILlm): OneShotPlanning | ReplanOnErrorPlanning | SkillStepsPlanning;
+/**
+ * Default coordinator dispatch kind. Omitted → 'hybrid' for ALL planning kinds:
+ * agentless steps — the synthesized answer-directly step (#155) and skill steps
+ * without an explicit `agent:` — need a self-LLM fallback. Pin 'subagent'
+ * explicitly for strict subagent-only routing.
+ */
+export declare function resolveCoordinatorDispatchKind(explicit?: 'subagent' | 'self' | 'hybrid'): 'subagent' | 'self' | 'hybrid';
 export declare function resolveCoordinatorDispatch(name: string, fallbackLlm?: ILlm, contextBuilder?: ISubAgentContextBuilder): SubAgentDispatch | SelfDispatch | HybridDispatch;
 export declare function resolveCoordinatorActivation(name: string): AutoActivation | ExplicitActivation;
 export declare function resolveToolSelectionStrategy(name: string, params?: {
@@ -48,10 +117,27 @@ export interface ResolveConfigArgs {
     'plugin-dir'?: string;
     mode?: string | boolean;
 }
-export declare const YAML_TEMPLATE = "port: 4004\nhost: 0.0.0.0\n\n# Request routing mode:\n#   hard        \u2014 Fully managed context. Ignores client history/system prompt. Uses RAG + internal MCP tools only.\n#   pass        \u2014 Transparent proxy. Logs everything but modifies nothing.\n#   smart       \u2014 Hybrid. Preserves client history but enriches it with RAG context and MCP tools based on analysis. (default)\nmode: smart\n\nllm:\n  provider: deepseek                  # deepseek | openai | anthropic | sap-ai-sdk | ollama\n  apiKey: ${DEEPSEEK_API_KEY}        # not required for ollama / sap-ai-sdk\n  model: deepseek-chat\n  temperature: 0.7\n  classifierTemperature: 0.1\n\nrag:\n  type: in-memory                     # in-memory | qdrant | hana-vector | pg-vector\n  embedder: ollama                    # Embedder to use: ollama | openai | sap-ai-core | <custom>\n  url: http://localhost:11434\n  model: bge-m3\n  # resourceGroup: default            # SAP AI Core resource group (sap-ai-core embedder)\n  # scenario: orchestration           # SAP AI Core scenario: orchestration (default) | foundation-models\n  # collectionName: llm-agent         # Collection/table name (qdrant | hana-vector | pg-vector)\n  dedupThreshold: 0.92\n  vectorWeight: 0.7                   # Semantic similarity weight (0..1)\n  keywordWeight: 0.3                  # Lexical matching weight (0..1)\n\nmcp:\n  # type: none | http | stdio\n  # To disable MCP, set type to 'none'\n  type: http\n  url: http://localhost:3001/mcp/stream/http\n\nagent:\n  externalToolsValidationMode: permissive  # permissive | strict\n  maxIterations: 10\n  maxToolCalls: 30\n  toolUnavailableTtlMs: 600000       # Temporary tool blacklist TTL (ms)\n  ragQueryK: 10\n  # contextBudgetTokens: 4000          # Max tokens for RAG context in system prompt (0 = no limit)\n  # semanticHistoryEnabled: false      # Enable semantic history via RAG\n  # historyRecencyWindow: 4            # Last N messages from client history in LLM context\n  # historyTurnSummaryPrompt: \"...\"    # LLM prompt for turn summarization\n  showReasoning: false                # Explain strategy at start of response\n  historyAutoSummarizeLimit: 10       # History length to trigger compression\n  queryExpansionEnabled: false        # Expand RAG queries with LLM-generated synonyms\n  toolResultCacheTtlMs: 300000       # Tool result cache TTL (ms); 0 to disable\n  sessionTokenBudget: 0              # Multi-turn token budget; 0 to disable\n  # ragTranslateEnabled: true        # Translate non-ASCII RAG queries to English (default: true)\n  # classificationEnabled: false     # Enable for custom pipelines with multi-store routing\n  # toolReselectPerIteration: false  # Re-select tools via RAG on each tool-loop iteration\n  # llmCallStrategy: streaming       # streaming | non-streaming | fallback\n  # streamMode: full                 # full | final \u2014 streaming behavior for tool loops\n  # heartbeatIntervalMs: 5000       # SSE heartbeat interval during tool execution (ms)\n  # healthTimeoutMs: 5000            # Health check probe timeout (ms); increase for slow providers (SAP AI Core: 15000)\n  # retry:                           # LLM retry config for 429/5xx errors\n  #   maxAttempts: 3\n  #   backoffMs: 1000\n  #   retryOn: [429, 500, 502, 503]\n  #   retryOnMidStream: ['SSE stream']  # Substrings triggering mid-stream retry\n\n# --- Advanced Multi-Model Pipeline (optional) -------------------------------\n# Use this section to assign different models for different internal tasks.\n# pipeline:\n#   llm:\n#     main:\n#       provider: deepseek            # deepseek | openai | anthropic | sap-ai-sdk\n#       apiKey: ${DEEPSEEK_API_KEY}\n#       model: deepseek-chat\n#       temperature: 0.7\n#       streaming: true               # false to disable streaming for this provider\n#     classifier:                     # optional; if absent, main config is reused\n#       provider: deepseek\n#       apiKey: ${DEEPSEEK_API_KEY}\n#       model: deepseek-chat\n#       temperature: 0.1\n#     helper:                         # optional; if absent, main config is reused\n#       provider: deepseek\n#       apiKey: ${DEEPSEEK_API_KEY}\n#       model: deepseek-chat\n#       temperature: 0.1\n#\n#   rag:\n#     tools:\n#       type: qdrant\n#       url: http://qdrant:6333\n#       embedder: openai              # ollama | openai | <custom registered name>\n#       model: text-embedding-3-small\n#       apiKey: ${OPENAI_API_KEY}\n#     history:\n#       type: in-memory\n#\n#   mcp:\n#     - type: http\n#       url: http://localhost:3001/mcp/stream/http\n\n# --- Structured Pipeline (optional) -------------------------------------------\n# Replaces the hardcoded orchestration flow with a YAML-defined stage tree.\n# When absent, the default flow runs unchanged (full backwards compatibility).\n#\n# pipeline:\n#   version: \"1\"\n#   stages:\n#     - id: classify\n#       type: classify\n#     - id: summarize\n#       type: summarize\n#     - id: rag-retrieval\n#       type: parallel\n#       when: \"shouldRetrieve\"\n#       stages:\n#         - { id: translate, type: translate }\n#         - { id: expand, type: expand }\n#       after:\n#         - id: rag-queries\n#           type: parallel\n#           stages:\n#             - { id: tools, type: rag-query, config: { store: tools, k: 10 } }\n#             - { id: history, type: rag-query, config: { store: history, k: 5 } }\n#         - { id: rerank, type: rerank }\n#         - { id: tool-select, type: tool-select }\n#     - id: assemble\n#       type: assemble\n#     - id: tool-loop\n#       type: tool-loop\n\n# prompts:\n#   system: \"You are a helpful assistant specialized in SAP ABAP development.\"\n#   classifier: |\n#     You are an intent classifier... (see source for full default prompt)\n#   reasoning: |\n#     IMPORTANT: Always start your response with a brief <reasoning> block...\n#   ragTranslate: |\n#     Translate the user request to English for search purposes...\n#   historySummary: |\n#     Summarize the conversation so far...\n\nlog: smart-server.log                 # path to log file; omit for stdout\n# logDir: sessions                    # Directory for detailed session debug logs\n# pluginDir: ./my-plugins             # Additional plugin directory (loaded after defaults)\n\n# subagents:                          # Optional: nested agents callable from pipeline\n#   - name: code-reviewer             # Used as stage config: { agent: code-reviewer }\n#     description: |                  # Optional. Shown to the Coordinator planner LLM\n#       Reviews code and returns      # so it can pick this agent for the right step.\n#       structured JSON.\n#     config: ./agents/code-reviewer.yaml\n\n# coordinator:                        # Optional: enable autonomous plan-execute loop\n#   planning: one-shot                # one-shot | replan-on-error | skill-steps\n#   dispatch: subagent                # subagent | self | hybrid\n#   activation: explicit              # explicit (default) | auto\n#   plannerLlm: main                  # main | planner | helper (unused by skill-steps)\n#   maxSteps: 12\n#   maxRetriesPerStep: 1\n#   failPolicy: abort                 # abort | continue\n#   maxLayer: 1                       # Max nested-dispatch depth (default 1)\n";
+export declare const YAML_TEMPLATE = "port: 4004\nhost: 0.0.0.0\n\n# Request routing mode:\n#   hard        \u2014 Fully managed context. Ignores client history/system prompt. Uses RAG + internal MCP tools only.\n#   pass        \u2014 Transparent proxy. Logs everything but modifies nothing.\n#   smart       \u2014 Hybrid. Preserves client history but enriches it with RAG context and MCP tools based on analysis. (default)\nmode: smart\n\nllm:\n  provider: deepseek                  # deepseek | openai | anthropic | sap-ai-sdk | ollama\n  apiKey: ${DEEPSEEK_API_KEY}        # not required for ollama / sap-ai-sdk\n  model: deepseek-chat\n  temperature: 0.7\n  classifierTemperature: 0.1\n\nrag:\n  type: in-memory                     # in-memory | qdrant | hana-vector | pg-vector\n  embedder: ollama                    # Embedder to use: ollama | openai | sap-ai-core | <custom>\n  url: http://localhost:11434\n  model: bge-m3\n  # resourceGroup: default            # SAP AI Core resource group (sap-ai-core embedder)\n  # scenario: orchestration           # SAP AI Core scenario: orchestration (default) | foundation-models\n  # collectionName: llm-agent         # Collection/table name (qdrant | hana-vector | pg-vector)\n  dedupThreshold: 0.92\n  vectorWeight: 0.7                   # Semantic similarity weight (0..1)\n  keywordWeight: 0.3                  # Lexical matching weight (0..1)\n\nmcp:\n  # type: none | http | stdio\n  # To disable MCP, set type to 'none'\n  type: http\n  url: http://localhost:3001/mcp/stream/http\n\nagent:\n  externalToolsValidationMode: permissive  # permissive | strict\n  maxIterations: 10\n  maxToolCalls: 30\n  toolUnavailableTtlMs: 600000       # Temporary tool blacklist TTL (ms)\n  ragQueryK: 10\n  # contextBudgetTokens: 4000          # Max tokens for RAG context in system prompt (0 = no limit)\n  # semanticHistoryEnabled: false      # Enable semantic history via RAG\n  # historyRecencyWindow: 4            # Last N messages from client history in LLM context\n  # historyTurnSummaryPrompt: \"...\"    # LLM prompt for turn summarization\n  showReasoning: false                # Explain strategy at start of response\n  historyAutoSummarizeLimit: 10       # History length to trigger compression\n  queryExpansionEnabled: false        # Expand RAG queries with LLM-generated synonyms\n  toolResultCacheTtlMs: 300000       # Tool result cache TTL (ms); 0 to disable\n  sessionTokenBudget: 0              # Multi-turn token budget; 0 to disable\n  # ragTranslateEnabled: true        # Translate non-ASCII RAG queries to English (default: true)\n  # classificationEnabled: false     # Enable for custom pipelines with multi-store routing\n  # toolReselectPerIteration: false  # Re-select tools via RAG on each tool-loop iteration\n  # llmCallStrategy: streaming       # streaming | non-streaming | fallback\n  # streamMode: full                 # full | final \u2014 streaming behavior for tool loops\n  # heartbeatIntervalMs: 5000       # SSE heartbeat interval during tool execution (ms)\n  # healthTimeoutMs: 5000            # Health check probe timeout (ms); increase for slow providers (SAP AI Core: 15000)\n  # retry:                           # LLM retry config for 429/5xx errors\n  #   maxAttempts: 3\n  #   backoffMs: 1000\n  #   retryOn: [429, 500, 502, 503]\n  #   retryOnMidStream: ['SSE stream']  # Substrings triggering mid-stream retry\n\n# --- Advanced Multi-Model Pipeline (optional) -------------------------------\n# Use this section to assign different models for different internal tasks.\n# pipeline:\n#   llm:\n#     main:\n#       provider: deepseek            # deepseek | openai | anthropic | sap-ai-sdk\n#       apiKey: ${DEEPSEEK_API_KEY}\n#       model: deepseek-chat\n#       temperature: 0.7\n#       streaming: true               # false to disable streaming for this provider\n#     classifier:                     # optional; if absent, main config is reused\n#       provider: deepseek\n#       apiKey: ${DEEPSEEK_API_KEY}\n#       model: deepseek-chat\n#       temperature: 0.1\n#     helper:                         # optional; if absent, main config is reused\n#       provider: deepseek\n#       apiKey: ${DEEPSEEK_API_KEY}\n#       model: deepseek-chat\n#       temperature: 0.1\n#\n#   rag:\n#     tools:\n#       type: qdrant\n#       url: http://qdrant:6333\n#       embedder: openai              # ollama | openai | <custom registered name>\n#       model: text-embedding-3-small\n#       apiKey: ${OPENAI_API_KEY}\n#     history:\n#       type: in-memory\n#\n#   mcp:\n#     - type: http\n#       url: http://localhost:3001/mcp/stream/http\n\n# --- Structured Pipeline (optional) -------------------------------------------\n# Replaces the hardcoded orchestration flow with a YAML-defined stage tree.\n# When absent, the default flow runs unchanged (full backwards compatibility).\n#\n# pipeline:\n#   version: \"1\"\n#   stages:\n#     - id: classify\n#       type: classify\n#     - id: summarize\n#       type: summarize\n#     - id: rag-retrieval\n#       type: parallel\n#       when: \"shouldRetrieve\"\n#       stages:\n#         - { id: translate, type: translate }\n#         - { id: expand, type: expand }\n#       after:\n#         - id: rag-queries\n#           type: parallel\n#           stages:\n#             - { id: tools, type: rag-query, config: { store: tools, k: 10 } }\n#             - { id: history, type: rag-query, config: { store: history, k: 5 } }\n#         - { id: rerank, type: rerank }\n#         - { id: tool-select, type: tool-select }\n#     - id: assemble\n#       type: assemble\n#     - id: tool-loop\n#       type: tool-loop\n\n# prompts:\n#   system: \"You are a helpful assistant specialized in SAP ABAP development.\"\n#   classifier: |\n#     You are an intent classifier... (see source for full default prompt)\n#   reasoning: |\n#     IMPORTANT: Always start your response with a brief <reasoning> block...\n#   ragTranslate: |\n#     Translate the user request to English for search purposes...\n#   historySummary: |\n#     Summarize the conversation so far...\n\nlog: smart-server.log                 # path to log file; omit for stdout\n# logDir: sessions                    # Directory for detailed session debug logs\n# pluginDir: ./my-plugins             # Additional plugin directory (loaded after defaults)\n\n# subagents:                          # Optional: nested agents callable from pipeline\n#   - name: code-reviewer             # Used as stage config: { agent: code-reviewer }\n#     description: |                  # Optional. Shown to the Coordinator planner LLM\n#       Reviews code and returns      # so it can pick this agent for the right step.\n#       structured JSON.\n#     config: ./agents/code-reviewer.yaml\n\n# coordinator:                        # Optional: enable autonomous plan-execute loop\n#   planning: one-shot                # one-shot | replan-on-error | skill-steps\n#   dispatch: subagent                # subagent | self | hybrid\n#   activation: explicit              # explicit (default) | auto\n#   plannerLlm: main                  # main | planner | helper (unused by skill-steps)\n#   maxSteps: 12\n#   maxRetriesPerStep: 1\n#   failPolicy: abort                 # abort | continue\n#   maxLayer: 1                       # DEPRECATED \u2014 accepted but ignored (nested\n#                                     # dispatch removed; subagents are leaves)\n";
 export declare function resolveEnvVars(value: unknown, env?: NodeJS.ProcessEnv): unknown;
 export declare function loadYamlConfig(filePath: string, env?: NodeJS.ProcessEnv): YamlConfig;
 export declare function generateConfigTemplate(outputPath: string): void;
+export type FinalizerYaml = {
+    type?: 'passthrough' | 'llm' | 'template';
+    finalizerLlm?: string;
+    systemPrompt?: string;
+};
+/**
+ * Build the IFinalizer impl from `coordinator.finalizer:` YAML.
+ *
+ * Lookup chain for `type: llm`:
+ *   resolveLlmConfig(llmMap, cfg.finalizerLlm, pipelineFallback)
+ *   → top-level llm.<name> → llm.main → pipelineFallback (pipeline.llm.main)
+ *   → ConfigError if all three are missing.
+ *
+ * Absent block / `type: passthrough` → PassthroughFinalizer.
+ * `type: template` → TemplateFinalizer.
+ */
+export declare function buildFinalizer(cfg: FinalizerYaml | undefined, llmMap: NormalizedLlmMap | undefined, pipelineFallback: SmartServerLlmConfig | undefined, makeLlm: (config: SmartServerLlmConfig) => Promise<ILlm>): Promise<IFinalizer>;
 export interface ResolveSmartServerConfigOptions {
     /**
      * Filesystem path of the YAML config that produced `yaml`. Required for

package/dist/smart-agent/config.d.ts.map

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

package/dist/smart-agent/config.js

@@ -3,8 +3,172 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
-import { AutoActivation, ExplicitActivation, HybridDispatch, OneShotPlanning, ReplanOnErrorPlanning, ScoreThresholdToolSelection, SelfDispatch, SkillStepsPlanning, SubAgentDispatch, TopKToolSelection, } from '@mcp-abap-adt/llm-agent-libs';
+import { AutoActivation, ExplicitActivation, HybridDispatch, LlmFinalizer, OneShotPlanning, PassthroughFinalizer, ReplanOnErrorPlanning, ScoreThresholdToolSelection, SelfDispatch, SkillStepsPlanning, SubAgentDispatch, TemplateFinalizer, TopKToolSelection, } from '@mcp-abap-adt/llm-agent-libs';
 import { parse as parseYaml } from 'yaml';
+/**
+ * Detect whether an object is a flat SmartServerLlmConfig shape.
+ * Flat shape is identified by the presence of ANY of the known flat-shape
+ * fields: `provider`, `apiKey`, `model`, or `url`. This covers keyless
+ * providers (Ollama, SAP AI Core) that omit `apiKey` — using `apiKey`-only
+ * detection silently misclassified those configs as a "map" shape.
+ */
+function isFlatLlmConfig(input) {
+    const flat = input;
+    return (typeof flat.provider === 'string' ||
+        typeof flat.apiKey === 'string' ||
+        typeof flat.model === 'string' ||
+        typeof flat.url === 'string');
+}
+/**
+ * Normalize the optional top-level `llm:` block.
+ * - undefined → undefined (pipeline-only configs stay valid)
+ * - flat shape (has `provider` | `apiKey` | `model` | `url`) → { main: flat } (backward compat)
+ * - map shape → must include `main`; returned as NormalizedLlmMap
+ */
+export function normalizeLlmConfig(input) {
+    if (input === undefined)
+        return undefined;
+    if (isFlatLlmConfig(input)) {
+        return { main: input };
+    }
+    const map = input;
+    if (!map.main) {
+        throw new Error("llm: map must include a 'main' key (default LLM for unspecified roles)");
+    }
+    return map;
+}
+/**
+ * Strict lookup: returns map[name] if explicitly present, else undefined.
+ * Does NOT fall through to map.main. Use when the caller needs to
+ * detect explicit-presence (e.g. to decide between an alias and the
+ * named map entry).
+ */
+export function resolveLlmConfigStrict(map, name) {
+    if (!map || !name)
+        return undefined;
+    return map[name];
+}
+/**
+ * Resolve a per-role LLM config by name from a normalized map.
+ * Lookup chain: map[name] → map.main → pipelineFallback.
+ * When map is undefined, falls back to pipelineFallback (so pipeline-only
+ * configs keep working with no top-level llm: block).
+ *
+ * The caller decides whether `undefined` is an error.
+ */
+export function resolveLlmConfig(map, name, pipelineFallback) {
+    if (!map)
+        return pipelineFallback;
+    if (!name || name === 'main')
+        return map.main;
+    return map[name] ?? map.main;
+}
+/**
+ * Read the reviewer block's LLM-name selector, accepting both the
+ * preferred `reviewerLlm` field and the deprecated `plannerLlm` alias.
+ * When the alias is used, calls `warn(message)`.
+ */
+export function resolveReviewerLlmName(block, warn) {
+    if (!block)
+        return undefined;
+    if (typeof block.reviewerLlm === 'string')
+        return block.reviewerLlm;
+    if (typeof block.plannerLlm === 'string') {
+        warn("coordinator.reviewer.plannerLlm is deprecated; rename to 'reviewerLlm'");
+        return block.plannerLlm;
+    }
+    return undefined;
+}
+const LINEAR_ONLY = [
+    'planning',
+    'dispatch',
+    'maxSteps',
+    'maxRetriesPerStep',
+    'failPolicy',
+    'maxLayer',
+    'plannerLlm',
+];
+const DAG_ONLY = [
+    'planner',
+    'interpreter',
+    'reviewer',
+    'errorStrategy',
+    'finalizer',
+    'stateOracle',
+    'maxRoundTrips',
+];
+/** Validate a coordinator role block shape. */
+function assertLlmRoleShape(label, role) {
+    if (typeof role !== 'object' || role === null || Array.isArray(role)) {
+        throw new Error(`coordinator.${label} must be an object (e.g. { type: llm }), got: ${JSON.stringify(role)}`);
+    }
+    const kind = role.type;
+    if (kind !== undefined &&
+        kind !== 'llm' &&
+        !(label === 'finalizer' && (kind === 'passthrough' || kind === 'template'))) {
+        throw new Error(`coordinator.${label}: unknown type '${String(kind)}'`);
+    }
+    for (const field of ['plannerLlm', 'reviewerLlm', 'finalizerLlm']) {
+        const sel = role[field];
+        if (sel !== undefined && typeof sel !== 'string') {
+            throw new Error(`coordinator.${label}.${field} must be a string referencing an llm.* key, got: ${String(sel)}`);
+        }
+    }
+    const sp = role.systemPrompt;
+    if (sp !== undefined && typeof sp !== 'string') {
+        throw new Error(`coordinator.${label}.systemPrompt must be a string, got: ${String(sp)}`);
+    }
+}
+function assertErrorStrategyShape(es) {
+    if (typeof es !== 'object' || es === null || Array.isArray(es)) {
+        throw new Error(`coordinator.errorStrategy must be an object (e.g. { type: replan }), got: ${JSON.stringify(es)}`);
+    }
+    const type = es.type;
+    if (type !== undefined && type !== 'abort' && type !== 'replan') {
+        throw new Error(`coordinator.errorStrategy: unknown type '${String(type)}' (only 'abort' | 'replan')`);
+    }
+    const mr = es.maxReplans;
+    if (mr !== undefined && (typeof mr !== 'number' || mr < 0)) {
+        throw new Error(`coordinator.errorStrategy.maxReplans must be a non-negative number, got: ${String(mr)}`);
+    }
+}
+/** Fail-loud guard: a coordinator block is either DAG (has `planner`) or linear,
+ *  never mixed. `activation` is shared and always allowed. */
+export function assertCoordinatorConfigShape(coord) {
+    const isDag = coord.planner !== undefined;
+    if (isDag) {
+        assertLlmRoleShape('planner', coord.planner);
+        if (coord.reviewer !== undefined) {
+            assertLlmRoleShape('reviewer', coord.reviewer);
+        }
+        if (coord.finalizer !== undefined) {
+            assertLlmRoleShape('finalizer', coord.finalizer);
+        }
+        if (coord.errorStrategy !== undefined) {
+            assertErrorStrategyShape(coord.errorStrategy);
+        }
+        if (coord.stateOracle !== undefined &&
+            typeof coord.stateOracle !== 'string') {
+            throw new Error(`coordinator.stateOracle must be a string (a declared subagent name), got: ${JSON.stringify(coord.stateOracle)}`);
+        }
+        if (coord.maxRoundTrips !== undefined &&
+            (typeof coord.maxRoundTrips !== 'number' || coord.maxRoundTrips < 0)) {
+            throw new Error(`coordinator.maxRoundTrips must be a non-negative number, got: ${String(coord.maxRoundTrips)}`);
+        }
+        for (const f of LINEAR_ONLY) {
+            if (coord[f] !== undefined) {
+                throw new Error(`coordinator: '${f}' is a linear-only field and cannot be combined with 'planner' (DAG mode)`);
+            }
+        }
+    }
+    else {
+        for (const f of DAG_ONLY) {
+            if (coord[f] !== undefined) {
+                throw new Error(`coordinator: '${f}' is a DAG-only field; a linear coordinator uses 'planning'/'dispatch'`);
+            }
+        }
+    }
+}
 export function resolveCoordinatorPlanning(name, plannerLlm) {
     switch (name) {
         case 'one-shot':
@@ -20,6 +184,15 @@ export function resolveCoordinatorPlanning(name, plannerLlm) {
             throw new Error(`Unknown coordinator.planning strategy: '${name}'. Allowed: one-shot, replan-on-error, skill-steps.`);
     }
 }
+/**
+ * Default coordinator dispatch kind. Omitted → 'hybrid' for ALL planning kinds:
+ * agentless steps — the synthesized answer-directly step (#155) and skill steps
+ * without an explicit `agent:` — need a self-LLM fallback. Pin 'subagent'
+ * explicitly for strict subagent-only routing.
+ */
+export function resolveCoordinatorDispatchKind(explicit) {
+    return explicit ?? 'hybrid';
+}
 export function resolveCoordinatorDispatch(name, fallbackLlm, contextBuilder) {
     switch (name) {
         case 'subagent':
@@ -241,7 +414,8 @@ log: smart-server.log                 # path to log file; omit for stdout
 #   maxSteps: 12
 #   maxRetriesPerStep: 1
 #   failPolicy: abort                 # abort | continue
-#   maxLayer: 1                       # Max nested-dispatch depth (default 1)
+#   maxLayer: 1                       # DEPRECATED — accepted but ignored (nested
+#                                     # dispatch removed; subagents are leaves)
 `;
 export function resolveEnvVars(value, env = process.env) {
     if (typeof value === 'string')
@@ -262,6 +436,33 @@ export function loadYamlConfig(filePath, env = process.env) {
 export function generateConfigTemplate(outputPath) {
     fs.writeFileSync(outputPath, YAML_TEMPLATE, 'utf8');
 }
+/**
+ * Build the IFinalizer impl from `coordinator.finalizer:` YAML.
+ *
+ * Lookup chain for `type: llm`:
+ *   resolveLlmConfig(llmMap, cfg.finalizerLlm, pipelineFallback)
+ *   → top-level llm.<name> → llm.main → pipelineFallback (pipeline.llm.main)
+ *   → ConfigError if all three are missing.
+ *
+ * Absent block / `type: passthrough` → PassthroughFinalizer.
+ * `type: template` → TemplateFinalizer.
+ */
+export async function buildFinalizer(cfg, llmMap, pipelineFallback, makeLlm) {
+    const kind = cfg?.type ?? 'passthrough';
+    if (kind === 'passthrough')
+        return new PassthroughFinalizer();
+    if (kind === 'template')
+        return new TemplateFinalizer();
+    // kind === 'llm'
+    const resolved = resolveLlmConfig(llmMap, cfg?.finalizerLlm, pipelineFallback);
+    if (!resolved) {
+        throw new Error('coordinator.finalizer (type: llm) requires an LLM config: provide top-level llm.<name>, llm.main, or pipeline.llm.main');
+    }
+    const llm = await makeLlm(resolved);
+    return new LlmFinalizer(llm, {
+        systemPrompt: cfg?.systemPrompt,
+    });
+}
 const get = (obj, ...keys) => keys.reduce((o, k) => {
     if (o !== null && typeof o === 'object' && k in o) {
         return o[k];
@@ -335,7 +536,10 @@ function checkRagStore(label, store, issues) {
         issues.push(`${label}.model: required when an embedder is used (e.g. bge-m3 for ollama)`);
     }
 }
-function validateResolvedConfig(resolved, yaml, env) {
+function validateLlmEntry(label, cfg, required, env, issues) {
+    checkLlmRole(label, cfg, required, env, issues);
+}
+function validateResolvedConfig(_resolved, yaml, env) {
     const issues = [];
     const usingPipeline = !!get(yaml, 'pipeline', 'llm', 'main');
     if (usingPipeline) {
@@ -349,11 +553,34 @@ function validateResolvedConfig(resolved, yaml, env) {
         }
     }
     else {
-        checkLlmRole('llm', {
-            provider: resolved.llm.provider,
-            apiKey: resolved.llm.apiKey,
-            model: resolved.llm.model,
-        }, true, env, issues);
+        // Read from the raw YAML so we can distinguish flat vs map shape.
+        // `resolved.llm` is always constructed as a flat object by resolveSmartServerConfig,
+        // so it cannot be used to detect the map shape.
+        const rawLlm = get(yaml, 'llm');
+        if (rawLlm === undefined) {
+            // No top-level llm: AND no pipeline.llm.main → would have been caught
+            // by `usingPipeline` branch. Defensive: surface a clear issue.
+            issues.push('llm: required when pipeline.llm.main is not configured');
+        }
+        else if (typeof rawLlm.provider === 'string') {
+            // Flat shape — existing behaviour.
+            validateLlmEntry('llm', rawLlm, true, env, issues);
+        }
+        else {
+            // Map shape — llm.main is required; every named entry is validated.
+            const map = rawLlm;
+            if (!map.main) {
+                issues.push("llm.main: required when 'llm' is a named map");
+            }
+            else {
+                validateLlmEntry('llm.main', map.main, true, env, issues);
+            }
+            for (const [name, entry] of Object.entries(map)) {
+                if (name === 'main')
+                    continue;
+                validateLlmEntry(`llm.${name}`, entry, true, env, issues);
+            }
+        }
     }
     if (get(yaml, 'mcp')) {
         const mcpType = get(yaml, 'mcp', 'type');
@@ -478,14 +705,18 @@ export function resolveSmartServerConfig(args = {}, yaml = {}, env = process.env
     const resolved = {
         port: Number(args.port ?? get(yaml, 'port') ?? env.PORT ?? 4004),
         host: args.host ?? get(yaml, 'host') ?? '0.0.0.0',
-        llm: {
-            provider: get(yaml, 'llm', 'provider'),
-            apiKey,
-            url: get(yaml, 'llm', 'url'),
-            model: get(yaml, 'llm', 'model'),
-            temperature: Number(get(yaml, 'llm', 'temperature') ?? 0.7),
-            classifierTemperature: Number(get(yaml, 'llm', 'classifierTemperature') ?? 0.1),
-        },
+        llm: get(yaml, 'llm')
+            ? typeof get(yaml, 'llm', 'provider') === 'string'
+                ? {
+                    provider: get(yaml, 'llm', 'provider'),
+                    apiKey,
+                    url: get(yaml, 'llm', 'url'),
+                    model: get(yaml, 'llm', 'model'),
+                    temperature: Number(get(yaml, 'llm', 'temperature') ?? 0.7),
+                    classifierTemperature: Number(get(yaml, 'llm', 'classifierTemperature') ?? 0.1),
+                }
+                : get(yaml, 'llm')
+            : undefined,
         rag: get(yaml, 'rag')
             ? {
                 type: get(yaml, 'rag', 'type'),