@mcp-abap-adt/llm-agent-server-libs 18.1.2 → 19.1.1

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "18.1.2";
+export declare const PACKAGE_VERSION = "19.1.1";
 //# 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 = '18.1.2';
+export const PACKAGE_VERSION = '19.1.1';
 //# sourceMappingURL=version.js.map

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './factories/index.js';
+export * from './pipelines/server-context.js';
 export * from './smart-agent/build-dag-coordinator-deps.js';
 export * from './smart-agent/build-stepper-root.js';
 export * from './smart-agent/config.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8CAA8C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8CAA8C,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './factories/index.js';
+export * from './pipelines/server-context.js';
 export * from './smart-agent/build-dag-coordinator-deps.js';
 export * from './smart-agent/build-stepper-root.js';
 export * from './smart-agent/config.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8CAA8C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8CAA8C,CAAC"}

package/dist/legacy/dag.d.ts

@@ -0,0 +1,4 @@
+export { DagCoordinatorHandler } from '@mcp-abap-adt/llm-agent-libs';
+export { DagFactory } from '../factories/index.js';
+export { buildDagCoordinatorDeps } from '../smart-agent/build-dag-coordinator-deps.js';
+//# sourceMappingURL=dag.d.ts.map

package/dist/legacy/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/legacy/dag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/legacy/dag.js

@@ -0,0 +1,4 @@
+export { DagCoordinatorHandler } from '@mcp-abap-adt/llm-agent-libs';
+export { DagFactory } from '../factories/index.js';
+export { buildDagCoordinatorDeps } from '../smart-agent/build-dag-coordinator-deps.js';
+//# sourceMappingURL=dag.js.map

package/dist/legacy/dag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.js","sourceRoot":"","sources":["../../src/legacy/dag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/legacy/flat.d.ts

@@ -0,0 +1,2 @@
+export { SmartAgentBuilder } from '@mcp-abap-adt/llm-agent-libs';
+//# sourceMappingURL=flat.d.ts.map

package/dist/legacy/flat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat.d.ts","sourceRoot":"","sources":["../../src/legacy/flat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/legacy/flat.js

@@ -0,0 +1,3 @@
+// No coordinator; expose the builder so a consumer can compose a flat agent.
+export { SmartAgentBuilder } from '@mcp-abap-adt/llm-agent-libs';
+//# sourceMappingURL=flat.js.map

package/dist/legacy/flat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat.js","sourceRoot":"","sources":["../../src/legacy/flat.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/legacy/linear.d.ts

@@ -0,0 +1,3 @@
+export { CoordinatorHandler } from '@mcp-abap-adt/llm-agent-libs';
+export { LinearFactory } from '../factories/index.js';
+//# sourceMappingURL=linear.d.ts.map

package/dist/legacy/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../src/legacy/linear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/legacy/linear.js

@@ -0,0 +1,3 @@
+export { CoordinatorHandler } from '@mcp-abap-adt/llm-agent-libs';
+export { LinearFactory } from '../factories/index.js';
+//# sourceMappingURL=linear.js.map

package/dist/legacy/linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../src/legacy/linear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/legacy/stepper.d.ts

@@ -0,0 +1,5 @@
+export { buildStepperCoordinator, CyclicFactory, DeepStepperFactory, PlannedFactory, } from '../factories/index.js';
+export { parseStepperCoordinatorConfig } from '../pipelines/parsers.js';
+export { buildFromComposition, buildStepperRoot, } from '../smart-agent/build-stepper-root.js';
+export { StepperCoordinatorHandler } from '../smart-agent/stepper-coordinator-handler.js';
+//# sourceMappingURL=stepper.d.ts.map

package/dist/legacy/stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/legacy/stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/legacy/stepper.js

@@ -0,0 +1,5 @@
+export { buildStepperCoordinator, CyclicFactory, DeepStepperFactory, PlannedFactory, } from '../factories/index.js';
+export { parseStepperCoordinatorConfig } from '../pipelines/parsers.js';
+export { buildFromComposition, buildStepperRoot, } from '../smart-agent/build-stepper-root.js';
+export { StepperCoordinatorHandler } from '../smart-agent/stepper-coordinator-handler.js';
+//# sourceMappingURL=stepper.js.map

package/dist/legacy/stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.js","sourceRoot":"","sources":["../../src/legacy/stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/pipelines/controller.d.ts

@@ -0,0 +1,19 @@
+import type { IPipelineInstance, IPipelinePlugin } from '@mcp-abap-adt/llm-agent';
+import type { ControllerConfig } from '../smart-agent/controller/types.js';
+import type { IControllerServerPipelineContext } from './server-context.js';
+export { ControllerCoordinatorHandler, type ControllerHandlerDeps, } from '../smart-agent/controller/controller-coordinator-handler.js';
+export { type ISubagentClient, makeSubagentClient, } from '../smart-agent/controller/subagent-client.js';
+export type { ControllerConfig, SessionBundle, } from '../smart-agent/controller/types.js';
+/**
+ * Built-in `controller` pipeline plugin. Validates the controller config
+ * dialect (three required subagent roles + defaulted target-state / session
+ * memory / budgets), wires the {@link ControllerCoordinatorHandler} from the
+ * server pipeline context, registers it on a fresh agent builder, and returns
+ * the runnable agent plus a disposal hook.
+ */
+export declare class ControllerPipelinePlugin implements IPipelinePlugin<ControllerConfig> {
+    readonly name = "controller";
+    parseConfig(raw: unknown): ControllerConfig;
+    build(cfg: ControllerConfig, ctx: IControllerServerPipelineContext): Promise<IPipelineInstance>;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/pipelines/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/pipelines/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAM5E,OAAO,EACL,4BAA4B,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,6DAA6D,CAAC;AACrE,OAAO,EACL,KAAK,eAAe,EACpB,kBAAkB,GACnB,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACV,gBAAgB,EAChB,aAAa,GACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;GAMG;AACH,qBAAa,wBACX,YAAW,eAAe,CAAC,gBAAgB,CAAC;IAE5C,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB;IA0CrC,KAAK,CACT,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,gCAAgC,GACpC,OAAO,CAAC,iBAAiB,CAAC;CAuD9B"}

package/dist/pipelines/controller.js

@@ -0,0 +1,100 @@
+import { ControllerCoordinatorHandler, } from '../smart-agent/controller/controller-coordinator-handler.js';
+import { makeSubagentClient } from '../smart-agent/controller/subagent-client.js';
+import { buildMcpBridge } from '../smart-agent/smart-server.js';
+// Re-export the controller building blocks so embedders (no-YAML) can compose
+// the coordinator directly onto their own SmartAgentBuilder via
+// `builder.withStepperCoordinator(new ControllerCoordinatorHandler(deps))`,
+// without going through the plugin/registry.
+export { ControllerCoordinatorHandler, } from '../smart-agent/controller/controller-coordinator-handler.js';
+export { makeSubagentClient, } from '../smart-agent/controller/subagent-client.js';
+/**
+ * Built-in `controller` pipeline plugin. Validates the controller config
+ * dialect (three required subagent roles + defaulted target-state / session
+ * memory / budgets), wires the {@link ControllerCoordinatorHandler} from the
+ * server pipeline context, registers it on a fresh agent builder, and returns
+ * the runnable agent plus a disposal hook.
+ */
+export class ControllerPipelinePlugin {
+    name = 'controller';
+    parseConfig(raw) {
+        const cfg = (raw ?? {});
+        const subagents = (cfg.subagents ?? {});
+        for (const role of ['evaluator', 'planner', 'executor']) {
+            if (subagents[role] === undefined) {
+                throw new Error(`pipeline 'controller' requires 'subagents.${role}' (each an LLM config with at least a 'provider')`);
+            }
+        }
+        const targetStateRaw = (cfg.targetState ?? {});
+        const sessionMemoryRaw = (cfg.sessionMemory ?? {});
+        const budgetsRaw = (cfg.budgets ?? {});
+        return {
+            subagents: subagents,
+            planner: (cfg.planner === 'adaptive'
+                ? 'adaptive'
+                : 'incremental'),
+            targetState: {
+                strategy: 'auto',
+                distanceThreshold: 0.25,
+                ...targetStateRaw,
+            },
+            sessionMemory: {
+                collection: 'session-memory',
+                ...sessionMemoryRaw,
+            },
+            budgets: {
+                maxSteps: 20,
+                maxRetries: 3,
+                maxRewinds: 5,
+                maxToolCalls: 10,
+                ...budgetsRaw,
+            },
+        };
+    }
+    async build(cfg, ctx) {
+        // Embedder is only needed for distance-based target-state strategies.
+        // consumer-confirm needs none, so an embedder-less deployment can use it.
+        const needsEmbedder = cfg.targetState.strategy === 'semantic-distance' ||
+            cfg.targetState.strategy === 'auto';
+        if (needsEmbedder && !ctx.embedder) {
+            throw new Error(`pipeline 'controller' targetState.strategy '${cfg.targetState.strategy}' requires an embedder (semantic distance); configure rag.embedder or use strategy: consumer-confirm`);
+        }
+        const [evaluatorLlm, plannerLlm, executorLlm] = await Promise.all([
+            ctx.makeLlm(cfg.subagents.evaluator),
+            ctx.makeLlm(cfg.subagents.planner),
+            ctx.makeLlm(cfg.subagents.executor),
+        ]);
+        const mcpClients = ctx.mcpClients ?? [];
+        const mcpBridge = buildMcpBridge(mcpClients);
+        // INTERNAL tools reach the executor/planner via SEMANTIC selection over the
+        // vectorized MCP catalog (toolsRag) — relevant top-K per query, not a full
+        // dump. The server vectorizes every MCP `tool:<name>` into toolsRag at
+        // startup. When no toolsRag is wired (MCP-less / no embedder) selection
+        // yields [] and the loop runs with external tools only.
+        const toolsRag = ctx.toolsRag;
+        const selectTools = (query, k, options) => toolsRag ? toolsRag.query(query, k, options) : Promise.resolve([]);
+        // NOTE: external-tool routing is decided PER-REQUEST inside the handler from
+        // `ctx.externalTools` (the client-supplied tools for that request). We do NOT
+        // wire `isExternalTool` here — the build-time server ctx never carries them.
+        const deps = {
+            evaluator: makeSubagentClient(evaluatorLlm),
+            planner: makeSubagentClient(plannerLlm),
+            executor: makeSubagentClient(executorLlm),
+            backend: ctx.stepperKnowledgeBackend,
+            knowledgeRagFor: (sessionId) => ctx.knowledgeRagFor(sessionId),
+            embedder: ctx.embedder,
+            callMcp: (name, args) => mcpBridge(name, args),
+            selectTools,
+            config: cfg,
+            models: {
+                evaluator: evaluatorLlm.model ?? 'unknown',
+                planner: plannerLlm.model ?? 'unknown',
+                executor: executorLlm.model ?? 'unknown',
+            },
+        };
+        const handler = new ControllerCoordinatorHandler(deps);
+        const builder = await ctx.createAgentBuilder();
+        const handle = await builder.withStepperCoordinator(handler).build();
+        return { agent: handle.agent, close: () => handle.close() };
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/pipelines/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/pipelines/controller.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,4BAA4B,GAE7B,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,8EAA8E;AAC9E,gEAAgE;AAChE,4EAA4E;AAC5E,6CAA6C;AAC7C,OAAO,EACL,4BAA4B,GAE7B,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAEL,kBAAkB,GACnB,MAAM,8CAA8C,CAAC;AAMtD;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAG1B,IAAI,GAAG,YAAY,CAAC;IAE7B,WAAW,CAAC,GAAY;QACtB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;QACnD,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAU,EAAE,CAAC;YACjE,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,mDAAmD,CACrG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAA4B,CAAC;QAC1E,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAGhD,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;QAElE,OAAO;YACL,SAAS,EAAE,SAA0C;YACrD,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,UAAU;gBAClC,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,aAAa,CAAgC;YACjD,WAAW,EAAE;gBACX,QAAQ,EAAE,MAAM;gBAChB,iBAAiB,EAAE,IAAI;gBACvB,GAAG,cAAc;aACiB;YACpC,aAAa,EAAE;gBACb,UAAU,EAAE,gBAAgB;gBAC5B,GAAG,gBAAgB;aACiB;YACtC,OAAO,EAAE;gBACP,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,EAAE;gBAChB,GAAG,UAAU;aACiB;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAqB,EACrB,GAAqC;QAErC,sEAAsE;QACtE,0EAA0E;QAC1E,MAAM,aAAa,GACjB,GAAG,CAAC,WAAW,CAAC,QAAQ,KAAK,mBAAmB;YAChD,GAAG,CAAC,WAAW,CAAC,QAAQ,KAAK,MAAM,CAAC;QACtC,IAAI,aAAa,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,+CAA+C,GAAG,CAAC,WAAW,CAAC,QAAQ,sGAAsG,CAC9K,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC;YACpC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC;YAClC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC;SACpC,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAE7C,4EAA4E;QAC5E,2EAA2E;QAC3E,uEAAuE;QACvE,wEAAwE;QACxE,wDAAwD;QACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC9B,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,CAAU,EAAE,OAAqB,EAAE,EAAE,CACvE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAErE,6EAA6E;QAC7E,8EAA8E;QAC9E,6EAA6E;QAC7E,MAAM,IAAI,GAA0B;YAClC,SAAS,EAAE,kBAAkB,CAAC,YAAY,CAAC;YAC3C,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,kBAAkB,CAAC,WAAW,CAAC;YACzC,OAAO,EAAE,GAAG,CAAC,uBAAuB;YACpC,eAAe,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC;YAC9D,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;YAC9C,WAAW;YACX,MAAM,EAAE,GAAG;YACX,MAAM,EAAE;gBACN,SAAS,EAAE,YAAY,CAAC,KAAK,IAAI,SAAS;gBAC1C,OAAO,EAAE,UAAU,CAAC,KAAK,IAAI,SAAS;gBACtC,QAAQ,EAAE,WAAW,CAAC,KAAK,IAAI,SAAS;aACzC;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/pipelines/dag.d.ts

@@ -0,0 +1,23 @@
+import type { IPipelineInstance, IPipelinePlugin } from '@mcp-abap-adt/llm-agent';
+import type { IServerPipelineContext } from './server-context.js';
+/** Config = the raw `coordinator:` (DAG) YAML block, validated by parseConfig. */
+export type DagPipelineConfig = Record<string, unknown>;
+/**
+ * Built-in `dag` pipeline plugin. Validates the raw DAG coordinator config
+ * (requires a `planner`), assembles the coordinator deps via the shared
+ * `buildDagCoordinatorDeps`, registers a `DagCoordinatorHandler` on a fresh
+ * agent builder, and returns the runnable agent plus a disposal hook.
+ *
+ * @deprecated Legacy pipeline. `dag` runs on its own legacy coordinator/step
+ * interpreter and stays selectable only for backward compatibility — it is not
+ * the active development path. The newer `controller` pipeline (incremental /
+ * adaptive planner) is the maintained interpreter; new deployments should use
+ * it. The controller interpreter was not designed to drive the legacy DAG flow,
+ * so do not migrate a `dag` config onto it. May be removed in a future major.
+ */
+export declare class DagPipelinePlugin implements IPipelinePlugin<DagPipelineConfig> {
+    readonly name = "dag";
+    parseConfig(raw: unknown): DagPipelineConfig;
+    build(cfg: DagPipelineConfig, ctx: IServerPipelineContext): Promise<IPipelineInstance>;
+}
+//# sourceMappingURL=dag.d.ts.map

package/dist/pipelines/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/pipelines/dag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,eAAe,CAAC,iBAAiB,CAAC;IAC1E,QAAQ,CAAC,IAAI,SAAS;IAEtB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB;IAQtC,KAAK,CACT,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAsB9B"}

package/dist/pipelines/dag.js

@@ -0,0 +1,46 @@
+import { DagCoordinatorHandler } from '@mcp-abap-adt/llm-agent-libs';
+import { buildDagCoordinatorDeps } from '../smart-agent/build-dag-coordinator-deps.js';
+/**
+ * Built-in `dag` pipeline plugin. Validates the raw DAG coordinator config
+ * (requires a `planner`), assembles the coordinator deps via the shared
+ * `buildDagCoordinatorDeps`, registers a `DagCoordinatorHandler` on a fresh
+ * agent builder, and returns the runnable agent plus a disposal hook.
+ *
+ * @deprecated Legacy pipeline. `dag` runs on its own legacy coordinator/step
+ * interpreter and stays selectable only for backward compatibility — it is not
+ * the active development path. The newer `controller` pipeline (incremental /
+ * adaptive planner) is the maintained interpreter; new deployments should use
+ * it. The controller interpreter was not designed to drive the legacy DAG flow,
+ * so do not migrate a `dag` config onto it. May be removed in a future major.
+ */
+export class DagPipelinePlugin {
+    name = 'dag';
+    parseConfig(raw) {
+        const cfg = (raw ?? {});
+        if (cfg.planner === undefined) {
+            throw new Error("pipeline 'dag' requires a 'planner' in its config");
+        }
+        return cfg;
+    }
+    async build(cfg, ctx) {
+        const deps = await buildDagCoordinatorDeps({
+            coordCfg: cfg,
+            llmMap: ctx.llmMap,
+            pipelineFallback: ctx.pipelineFallback,
+            mainLlm: ctx.mainLlm,
+            helperLlm: ctx.helperLlm,
+            mainTemp: ctx.mainTemp,
+            registry: ctx.workerRegistry,
+            makeLlm: (c) => ctx.makeLlm(c),
+            warn: (m) => ctx.warn(m),
+        });
+        if (!deps) {
+            throw new Error("pipeline 'dag': buildDagCoordinatorDeps returned undefined");
+        }
+        const handler = new DagCoordinatorHandler(deps);
+        const builder = await ctx.createAgentBuilder();
+        const handle = await builder.withStepperCoordinator(handler).build();
+        return { agent: handle.agent, close: () => handle.close() };
+    }
+}
+//# sourceMappingURL=dag.js.map

package/dist/pipelines/dag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.js","sourceRoot":"","sources":["../../src/pipelines/dag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAMvF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,KAAK,CAAC;IAEtB,WAAW,CAAC,GAAY;QACtB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;QACnD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAsB,EACtB,GAA2B;QAE3B,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC;YACzC,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,cAAc;YAC5B,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/pipelines/flat.d.ts

@@ -0,0 +1,14 @@
+import type { IPipelineInstance, IPipelinePlugin } from '@mcp-abap-adt/llm-agent';
+import type { IServerPipelineContext } from './server-context.js';
+/**
+ * Built-in `flat` pipeline plugin. No coordinator — just builds a plain
+ * {@link SmartAgent} with the base tool loop (no decomposition, planning, or
+ * multi-worker orchestration). Used for simple single-turn or stateless
+ * deployments.
+ */
+export declare class FlatPipelinePlugin implements IPipelinePlugin<Record<string, never>> {
+    readonly name = "flat";
+    parseConfig(): Record<string, never>;
+    build(_cfg: Record<string, never>, ctx: IServerPipelineContext): Promise<IPipelineInstance>;
+}
+//# sourceMappingURL=flat.d.ts.map

package/dist/pipelines/flat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat.d.ts","sourceRoot":"","sources":["../../src/pipelines/flat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,kBACX,YAAW,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAEjD,QAAQ,CAAC,IAAI,UAAU;IAEvB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAI9B,KAAK,CACT,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC3B,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAK9B"}

package/dist/pipelines/flat.js

@@ -0,0 +1,18 @@
+/**
+ * Built-in `flat` pipeline plugin. No coordinator — just builds a plain
+ * {@link SmartAgent} with the base tool loop (no decomposition, planning, or
+ * multi-worker orchestration). Used for simple single-turn or stateless
+ * deployments.
+ */
+export class FlatPipelinePlugin {
+    name = 'flat';
+    parseConfig() {
+        return {};
+    }
+    async build(_cfg, ctx) {
+        const builder = await ctx.createAgentBuilder();
+        const handle = await builder.build();
+        return { agent: handle.agent, close: () => handle.close() };
+    }
+}
+//# sourceMappingURL=flat.js.map

package/dist/pipelines/flat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat.js","sourceRoot":"","sources":["../../src/pipelines/flat.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAGpB,IAAI,GAAG,MAAM,CAAC;IAEvB,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,IAA2B,EAC3B,GAA2B;QAE3B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/pipelines/linear.d.ts

@@ -0,0 +1,17 @@
+import type { IPipelineInstance, IPipelinePlugin } from '@mcp-abap-adt/llm-agent';
+import type { IServerPipelineContext } from './server-context.js';
+/** Config = the raw `coordinator:` (linear) YAML block. */
+export type LinearPipelineConfig = Record<string, unknown>;
+/**
+ * Built-in `linear` pipeline plugin. The raw config is resolved into
+ * {@link CoordinatorHandlerDeps} (via {@link parseLinearConfig}) at build time
+ * (it needs `ctx` to resolve LLMs), wrapped by {@link LinearFactory} into a
+ * {@link CoordinatorHandler}, registered on a fresh agent builder, and returned
+ * as a runnable agent plus a disposal hook.
+ */
+export declare class LinearPipelinePlugin implements IPipelinePlugin<LinearPipelineConfig> {
+    readonly name = "linear";
+    parseConfig(raw: unknown): LinearPipelineConfig;
+    build(cfg: LinearPipelineConfig, ctx: IServerPipelineContext): Promise<IPipelineInstance>;
+}
+//# sourceMappingURL=linear.d.ts.map

package/dist/pipelines/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../src/pipelines/linear.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,qBAAa,oBACX,YAAW,eAAe,CAAC,oBAAoB,CAAC;IAEhD,QAAQ,CAAC,IAAI,YAAY;IAEzB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB;IAIzC,KAAK,CACT,GAAG,EAAE,oBAAoB,EACzB,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAU9B"}

package/dist/pipelines/linear.js

@@ -0,0 +1,26 @@
+import { LinearFactory } from '../factories/index.js';
+import { parseLinearConfig } from './parsers.js';
+/**
+ * Built-in `linear` pipeline plugin. The raw config is resolved into
+ * {@link CoordinatorHandlerDeps} (via {@link parseLinearConfig}) at build time
+ * (it needs `ctx` to resolve LLMs), wrapped by {@link LinearFactory} into a
+ * {@link CoordinatorHandler}, registered on a fresh agent builder, and returned
+ * as a runnable agent plus a disposal hook.
+ */
+export class LinearPipelinePlugin {
+    name = 'linear';
+    parseConfig(raw) {
+        return (raw ?? {});
+    }
+    async build(cfg, ctx) {
+        const deps = await parseLinearConfig(cfg, ctx);
+        const { handler } = await new LinearFactory().build(deps, {
+            makeRoleLlm: (role) => ctx.resolveLlm(role),
+            callMcp: (n, a, s) => ctx.callMcp(n, a, s).then(String),
+        });
+        const builder = await ctx.createAgentBuilder();
+        const handle = await builder.withStepperCoordinator(handler).build();
+        return { agent: handle.agent, close: () => handle.close() };
+    }
+}
+//# sourceMappingURL=linear.js.map

package/dist/pipelines/linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../src/pipelines/linear.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMjD;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAGtB,IAAI,GAAG,QAAQ,CAAC;IAEzB,WAAW,CAAC,GAAY;QACtB,OAAO,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAyB,EACzB,GAA2B;QAE3B,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;YACxD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3C,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;SACxD,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/pipelines/parsers.d.ts

@@ -0,0 +1,5 @@
+export { parseStepperCoordinatorConfig, type StepperCoordinatorConfig, } from '../smart-agent/config.js';
+import type { CoordinatorHandlerDeps } from '@mcp-abap-adt/llm-agent-libs';
+import type { IServerPipelineContext } from './server-context.js';
+export declare function parseLinearConfig(cfg: Record<string, unknown>, ctx: IServerPipelineContext): Promise<CoordinatorHandlerDeps>;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/pipelines/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/pipelines/parsers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAM3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAiBjC"}

package/dist/pipelines/parsers.js

@@ -0,0 +1,20 @@
+// PERMANENT facade: re-exports the pure parsers from config.ts (they STAY there;
+// build-stepper-root.ts and others import them from config.ts). Nothing is moved.
+export { parseStepperCoordinatorConfig, } from '../smart-agent/config.js';
+import { resolveCoordinatorDispatch, resolveCoordinatorDispatchKind, resolveCoordinatorPlanning, } from '../smart-agent/config.js';
+export async function parseLinearConfig(cfg, ctx) {
+    const plannerLlm = await ctx.resolveLlm('planner');
+    const planningKind = cfg.planning ??
+        'one-shot';
+    // resolveCoordinatorDispatchKind accepts only the dispatch union; cast after
+    // the YAML schema has constrained it.
+    const dispatchKind = resolveCoordinatorDispatchKind(cfg.dispatch);
+    return {
+        planning: resolveCoordinatorPlanning(planningKind, plannerLlm),
+        dispatch: resolveCoordinatorDispatch(dispatchKind, plannerLlm, undefined),
+        maxSteps: cfg.maxSteps ?? 10,
+        maxRetriesPerStep: cfg.maxRetriesPerStep ?? 1,
+        failPolicy: cfg.failPolicy ?? 'abort',
+    };
+}
+//# sourceMappingURL=parsers.js.map

package/dist/pipelines/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/pipelines/parsers.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,OAAO,EACL,6BAA6B,GAE9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAA4B,EAC5B,GAA2B;IAE3B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GACf,GAAG,CAAC,QAA2D;QAChE,UAAU,CAAC;IACb,6EAA6E;IAC7E,sCAAsC;IACtC,MAAM,YAAY,GAAG,8BAA8B,CACjD,GAAG,CAAC,QAAsD,CAC3D,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,0BAA0B,CAAC,YAAY,EAAE,UAAU,CAAC;QAC9D,QAAQ,EAAE,0BAA0B,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC;QACzE,QAAQ,EAAG,GAAG,CAAC,QAAmB,IAAI,EAAE;QACxC,iBAAiB,EAAG,GAAG,CAAC,iBAA4B,IAAI,CAAC;QACzD,UAAU,EAAG,GAAG,CAAC,UAAmC,IAAI,OAAO;KAChE,CAAC;AACJ,CAAC"}

package/dist/pipelines/server-context.d.ts

@@ -0,0 +1,53 @@
+import type { IEmbedder, ILlm, IPipelineContext, ISubAgent, IToolsRagHandle } from '@mcp-abap-adt/llm-agent';
+import type { KnowledgeBackend, SmartAgentBuilder } from '@mcp-abap-adt/llm-agent-libs';
+import type { NormalizedLlmMap } from '../smart-agent/config.js';
+import type { SmartServerLlmConfig } from '../smart-agent/smart-server.js';
+/**
+ * Server-side pipeline context. Extends the portable core IPipelineContext with
+ * the SmartAgentBuilder factory (host owns agent assembly) and the raw materials
+ * the DAG/linear coordinator builders need. Built-ins downcast IPipelineContext
+ * to this; the stepper variant uses only the core surface.
+ */
+export interface IServerPipelineContext extends IPipelineContext {
+    /** Builder pre-wired with all shared infra EXCEPT the coordinator. */
+    createAgentBuilder(): Promise<SmartAgentBuilder>;
+    makeLlm(cfg: SmartServerLlmConfig): Promise<ILlm>;
+    llmMap?: NormalizedLlmMap;
+    pipelineFallback?: SmartServerLlmConfig;
+    mainLlm: ILlm;
+    helperLlm?: ILlm;
+    mainTemp: number;
+    /** Session-scoped worker registry (DAG workers / linear subagents). */
+    workerRegistry: ReadonlyMap<string, ISubAgent>;
+    warn(msg: string): void;
+    /**
+     * Durable knowledge backend (session-bundle persistence + artifacts). The
+     * server always builds exactly one (`buildKnowledgeBackend`): JSONL when a
+     * `logDir` is set, else in-memory. Shared across sessions; consumed by the
+     * stepper/controller coordinators.
+     */
+    stepperKnowledgeBackend: KnowledgeBackend;
+    /**
+     * The embedder resolved once at startup from `rag.embedder` (or the configured
+     * embedder), shared with makeRag and the subagent context-builder. Used by the
+     * controller pipeline for target-state semantic distance. Undefined when no
+     * embedder is configured.
+     */
+    embedder?: IEmbedder;
+}
+/**
+ * Controller-pipeline view of the server context. With the durable knowledge
+ * backend and embedder now folded into the base {@link IServerPipelineContext}
+ * (external tools are routed per-REQUEST via `PipelineContext.externalTools`,
+ * not the build-time ctx), this is a transparent alias retained for the
+ * controller plugin / fixtures that reference it by name.
+ */
+export type IControllerServerPipelineContext = IServerPipelineContext;
+/** Always-present empty handle for no-RAG/no-MCP deployments. */
+export declare const EMPTY_TOOLS_RAG: IToolsRagHandle;
+/** Deps = the full context minus toolsRag (which the factory defaults). */
+export type ServerPipelineContextDeps = Omit<IServerPipelineContext, 'toolsRag'> & {
+    toolsRag?: IToolsRagHandle;
+};
+export declare function createServerPipelineContext(deps: ServerPipelineContextDeps): IServerPipelineContext;
+//# sourceMappingURL=server-context.d.ts.map

package/dist/pipelines/server-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-context.d.ts","sourceRoot":"","sources":["../../src/pipelines/server-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,IAAI,EACJ,gBAAgB,EAChB,SAAS,EACT,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,sEAAsE;IACtE,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEjD,OAAO,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,uBAAuB,EAAE,gBAAgB,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gCAAgC,GAAG,sBAAsB,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,eAG7B,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,sBAAsB,EACtB,UAAU,CACX,GAAG;IACF,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,yBAAyB,GAC9B,sBAAsB,CAExB"}

package/dist/pipelines/server-context.js

@@ -0,0 +1,9 @@
+/** Always-present empty handle for no-RAG/no-MCP deployments. */
+export const EMPTY_TOOLS_RAG = {
+    query: async () => [],
+    lookup: () => undefined,
+};
+export function createServerPipelineContext(deps) {
+    return { ...deps, toolsRag: deps.toolsRag ?? EMPTY_TOOLS_RAG };
+}
+//# sourceMappingURL=server-context.js.map

package/dist/pipelines/server-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-context.js","sourceRoot":"","sources":["../../src/pipelines/server-context.ts"],"names":[],"mappings":"AA0DA,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;IACrB,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;CACxB,CAAC;AAUF,MAAM,UAAU,2BAA2B,CACzC,IAA+B;IAE/B,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC;AACjE,CAAC"}

package/dist/pipelines/stepper.d.ts

@@ -0,0 +1,23 @@
+import type { IPipelineInstance, IPipelinePlugin } from '@mcp-abap-adt/llm-agent';
+import { type StepperCoordinatorConfig } from './parsers.js';
+import type { IServerPipelineContext } from './server-context.js';
+/**
+ * Built-in `stepper` pipeline plugin. Parses the coordinator config dialect,
+ * picks the matching builder-factory by `mode`, builds the coordinator stage
+ * handler, registers it on a fresh agent builder, and returns the runnable
+ * agent plus a disposal hook.
+ *
+ * @deprecated Legacy pipeline. `stepper` runs on its own legacy composition
+ * step-interpreter and stays selectable only for backward compatibility — it is
+ * not the active development path. The newer `controller` pipeline (incremental
+ * / adaptive planner) is the maintained interpreter; new deployments should use
+ * it. The controller interpreter was not designed to drive the legacy stepper
+ * flow, so do not migrate a `stepper` config onto it. May be removed in a future
+ * major.
+ */
+export declare class StepperPipelinePlugin implements IPipelinePlugin<StepperCoordinatorConfig> {
+    readonly name = "stepper";
+    parseConfig(raw: unknown): StepperCoordinatorConfig;
+    build(cfg: StepperCoordinatorConfig, ctx: IServerPipelineContext): Promise<IPipelineInstance>;
+}
+//# sourceMappingURL=stepper.d.ts.map

package/dist/pipelines/stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/pipelines/stepper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBACX,YAAW,eAAe,CAAC,wBAAwB,CAAC;IAEpD,QAAQ,CAAC,IAAI,aAAa;IAE1B,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,wBAAwB;IAM7C,KAAK,CACT,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAsC9B"}