@mcp-abap-adt/llm-agent-libs 12.0.4 → 12.1.0

package/dist/pipeline/handlers/coordinator-activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-activate.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/coordinator-activate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,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,0BAA2B,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEtD,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,OAAO,CAAC;CAkBpB"}

package/dist/pipeline/handlers/coordinator-activate.js

@@ -0,0 +1,37 @@
+/**
+ * CoordinatorActivateHandler — runtime activation decision for the
+ * coordinator stage.
+ *
+ * Built-time stage selection cannot see runtime ctx (selectedSkills are
+ * populated only after `skill-select` runs). This handler evaluates the
+ * configured `IActivationStrategy` against REAL ctx state and writes
+ * `ctx.coordinatorActive`. Coordinator and tool-loop stages gate on this
+ * flag via `when:` predicates so the activation decision honours runtime
+ * skill selection.
+ *
+ * Reads:  `ctx.subAgents`, `ctx.selectedSkills`.
+ * Writes: `ctx.coordinatorActive`.
+ */
+export class CoordinatorActivateHandler {
+    activation;
+    constructor(activation) {
+        this.activation = activation;
+    }
+    async execute(ctx, _rawConfig, _span) {
+        const hasSubAgents = (ctx.subAgents?.size ?? 0) > 0;
+        const hasStructuredSkill = ctx.selectedSkills.some((s) => (s.meta?.steps?.length ?? 0) > 0);
+        const active = this.activation.shouldActivate({
+            hasSubAgents,
+            hasStructuredSkill,
+        });
+        ctx.coordinatorActive = active;
+        ctx.options?.sessionLogger?.logStep('coordinator_activate', {
+            strategy: this.activation.name,
+            active,
+            hasSubAgents,
+            hasStructuredSkill,
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=coordinator-activate.js.map

package/dist/pipeline/handlers/coordinator-activate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-activate.js","sourceRoot":"","sources":["../../../src/pipeline/handlers/coordinator-activate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,UAAmC,EACnC,KAAY;QAEZ,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,kBAAkB,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CACxC,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAC5C,YAAY;YACZ,kBAAkB;SACnB,CAAC,CAAC;QACH,GAAG,CAAC,iBAAiB,GAAG,MAAM,CAAC;QAC/B,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,sBAAsB,EAAE;YAC1D,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC9B,MAAM;YACN,YAAY;YACZ,kBAAkB;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+/**
+ * CoordinatorHandler — plan-execute-replan loop driving autonomous
+ * multi-step orchestration over the SubAgent registry.
+ *
+ * Reads:  `ctx.subAgents`, `ctx.inputText`, `ctx.selectedSkills`,
+ *         `ctx.skillContent`, `ctx.assembledMessages` (for system prompt).
+ * Writes: `ctx.plan`, `ctx.currentStepIdx`, `ctx.stepResults`, and emits the
+ *         final concatenated output via `ctx.yield()` as the assistant
+ *         response (followed by a `stop` chunk), since the pipeline streams
+ *         results to consumers rather than buffering a final string field.
+ *
+ * NOTE: Coordinator replaces the tool-loop stage when activated. The
+ * `ctx.yield`-based streaming contract is preserved so downstream SSE
+ * consumers see the response as a normal stream.
+ */
+import type { IDispatchStrategy, IPlanningStrategy } from '@mcp-abap-adt/llm-agent';
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export interface CoordinatorHandlerDeps {
+    planning: IPlanningStrategy;
+    dispatch: IDispatchStrategy;
+    maxSteps: number;
+    maxRetriesPerStep: number;
+    failPolicy: 'abort' | 'continue';
+}
+export declare class CoordinatorHandler implements IStageHandler {
+    private readonly deps;
+    constructor(deps: CoordinatorHandlerDeps);
+    execute(ctx: PipelineContext, _rawConfig: Record<string, unknown>, _span: ISpan): Promise<boolean>;
+}
+/**
+ * Helper used by DefaultPipeline / activation strategies to detect whether
+ * the active skill carries a structured `steps` block — a strong signal for
+ * Coordinator activation.
+ */
+export declare function activeSkillHasSteps(ctx: PipelineContext): boolean;
+//# sourceMappingURL=coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EACjB,iBAAiB,EAIlB,MAAM,yBAAyB,CAAC;AAEjC,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,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC;CAClC;AAED,qBAAa,kBAAmB,YAAW,aAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,sBAAsB;IAEnD,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,OAAO,CAAC;CAkJpB;AAkCD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAEjE"}

package/dist/pipeline/handlers/coordinator.js

@@ -0,0 +1,184 @@
+/**
+ * CoordinatorHandler — plan-execute-replan loop driving autonomous
+ * multi-step orchestration over the SubAgent registry.
+ *
+ * Reads:  `ctx.subAgents`, `ctx.inputText`, `ctx.selectedSkills`,
+ *         `ctx.skillContent`, `ctx.assembledMessages` (for system prompt).
+ * Writes: `ctx.plan`, `ctx.currentStepIdx`, `ctx.stepResults`, and emits the
+ *         final concatenated output via `ctx.yield()` as the assistant
+ *         response (followed by a `stop` chunk), since the pipeline streams
+ *         results to consumers rather than buffering a final string field.
+ *
+ * NOTE: Coordinator replaces the tool-loop stage when activated. The
+ * `ctx.yield`-based streaming contract is preserved so downstream SSE
+ * consumers see the response as a normal stream.
+ */
+import { OrchestratorError } from '../../agent.js';
+export class CoordinatorHandler {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execute(ctx, _rawConfig, _span) {
+        // Normalise registry to an empty Map when no subagents are registered.
+        // SelfDispatch and other registry-free strategies must still run; the
+        // SubAgentDispatch strategy itself reports a clean StepResult when an
+        // unknown agent is requested, so we don't need a global gate here.
+        const registry = ctx.subAgents ?? new Map();
+        const coordCtx = {
+            inputText: ctx.inputText,
+            systemPrompt: collectSystemPrompt(ctx),
+            skillContent: collectSkillContent(ctx),
+            activeSkillMeta: collectActiveSkillMeta(ctx),
+            registry,
+            stepResults: {},
+            signal: ctx.options?.signal,
+            sessionId: ctx.sessionId,
+        };
+        let plan;
+        try {
+            plan = await this.deps.planning.buildInitialPlan(coordCtx);
+        }
+        catch (err) {
+            ctx.error = wrapError(err, 'COORDINATOR_PLAN_FAILED');
+            return false;
+        }
+        coordCtx.plan = plan;
+        ctx.plan = plan;
+        ctx.stepResults = coordCtx.stepResults;
+        ctx.options?.sessionLogger?.logStep('coordinator_plan', {
+            stepCount: plan.steps.length,
+            source: plan.source,
+            rationale: plan.rationale,
+        });
+        let totalSteps = 0;
+        while (totalSteps < this.deps.maxSteps) {
+            const idx = plan.steps.findIndex((s) => s.status === 'pending');
+            if (idx === -1)
+                break;
+            const step = plan.steps[idx];
+            step.status = 'in_progress';
+            ctx.currentStepIdx = idx;
+            ctx.options?.sessionLogger?.logStep('coordinator_step_start', {
+                stepId: step.id,
+                goal: step.goal,
+                agent: step.agent,
+            });
+            let result;
+            for (let attempt = 0; attempt <= this.deps.maxRetriesPerStep; attempt++) {
+                result = await this.deps.dispatch.dispatch(step, coordCtx);
+                if (result.ok)
+                    break;
+            }
+            if (!result) {
+                ctx.error = new OrchestratorError(`coordinator: dispatch returned no result for step ${step.id}`, 'COORDINATOR_NO_RESULT');
+                return false;
+            }
+            coordCtx.stepResults[step.id] = result;
+            step.status = result.ok ? 'done' : 'failed';
+            ctx.options?.sessionLogger?.logStep('coordinator_step_done', {
+                stepId: step.id,
+                ok: result.ok,
+                durationMs: result.durationMs,
+                outputLength: result.output.length,
+                error: result.error,
+            });
+            if (!result.ok) {
+                if (this.deps.planning.shouldReplan(coordCtx, result)) {
+                    const remaining = plan.steps.filter((s) => s.status === 'pending');
+                    try {
+                        plan = await this.deps.planning.rebuildPlan(coordCtx, remaining);
+                    }
+                    catch (err) {
+                        ctx.error = wrapError(err, 'COORDINATOR_REPLAN_FAILED');
+                        return false;
+                    }
+                    coordCtx.plan = plan;
+                    ctx.plan = plan;
+                    ctx.options?.sessionLogger?.logStep('coordinator_replan', {
+                        stepCount: plan.steps.length,
+                    });
+                }
+                else if (this.deps.failPolicy === 'abort') {
+                    ctx.error = new OrchestratorError(`coordinator: step ${step.id} failed and failPolicy=abort: ${result.error}`, 'COORDINATOR_STEP_FAILED');
+                    return false;
+                }
+            }
+            totalSteps++;
+        }
+        const hasPending = plan.steps.some((s) => s.status === 'pending');
+        const truncatedByLimit = totalSteps >= this.deps.maxSteps && hasPending;
+        const failedSteps = plan.steps.filter((s) => s.status === 'failed');
+        if (truncatedByLimit) {
+            ctx.options?.sessionLogger?.logStep('coordinator_max_steps', {
+                maxSteps: this.deps.maxSteps,
+                pendingCount: plan.steps.filter((s) => s.status === 'pending').length,
+            });
+        }
+        const stepBlocks = Object.values(coordCtx.stepResults)
+            .map((r) => `### ${r.stepId}\n${r.output}`)
+            .join('\n\n');
+        const completionNote = (() => {
+            if (truncatedByLimit) {
+                const pending = plan.steps.filter((s) => s.status === 'pending').length;
+                return `\n\n_[Coordinator: max steps (${this.deps.maxSteps}) reached, ${pending} step(s) still pending.]_`;
+            }
+            if (failedSteps.length > 0 && this.deps.failPolicy === 'continue') {
+                return `\n\n_[Coordinator: ${failedSteps.length} step(s) failed under failPolicy=continue.]_`;
+            }
+            return '';
+        })();
+        const finalOutput = stepBlocks + completionNote;
+        ctx.options?.sessionLogger?.logStep('coordinator_final', {
+            stepCount: Object.keys(coordCtx.stepResults).length,
+            outputLength: finalOutput.length,
+            truncated: truncatedByLimit,
+            failedSteps: failedSteps.length,
+        });
+        // Stream the final output as a single content chunk followed by a finish
+        // chunk. Mirrors tool-loop's contract so SSE consumers see a normal
+        // assistant response, but uses finishReason: 'length' when the plan was
+        // truncated by maxSteps — matching OpenAI's convention for limit-cut
+        // responses so clients can detect incompleteness.
+        ctx.yield({ ok: true, value: { content: finalOutput } });
+        ctx.yield({
+            ok: true,
+            value: {
+                content: '',
+                finishReason: truncatedByLimit ? 'length' : 'stop',
+            },
+        });
+        return true;
+    }
+}
+function collectSystemPrompt(ctx) {
+    const first = ctx.assembledMessages?.[0];
+    if (first && first.role === 'system' && typeof first.content === 'string') {
+        return first.content;
+    }
+    return undefined;
+}
+function collectSkillContent(ctx) {
+    if (typeof ctx.skillContent === 'string' && ctx.skillContent.length > 0) {
+        return ctx.skillContent;
+    }
+    return undefined;
+}
+function collectActiveSkillMeta(ctx) {
+    const withSteps = ctx.selectedSkills?.find((s) => (s.meta?.steps?.length ?? 0) > 0);
+    return withSteps?.meta;
+}
+function wrapError(err, code) {
+    if (err instanceof OrchestratorError)
+        return err;
+    return new OrchestratorError(err instanceof Error ? err.message : String(err), code);
+}
+/**
+ * Helper used by DefaultPipeline / activation strategies to detect whether
+ * the active skill carries a structured `steps` block — a strong signal for
+ * Coordinator activation.
+ */
+export function activeSkillHasSteps(ctx) {
+    return !!ctx.selectedSkills?.some((s) => (s.meta?.steps?.length ?? 0) > 0);
+}
+//# sourceMappingURL=coordinator.js.map

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

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

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

@@ -4,10 +4,12 @@
  * Maps built-in stage type names to their handler implementations.
  * Custom handlers can be registered by supplying a custom `IPipeline` implementation.
  */
+import type { IActivationStrategy, SubAgentRegistry } from '@mcp-abap-adt/llm-agent';
 import type { IStageHandler } from '../stage-handler.js';
 import { AssembleHandler } from './assemble.js';
 import { BuildToolQueryHandler } from './build-tool-query.js';
 import { ClassifyHandler } from './classify.js';
+import { type CoordinatorHandlerDeps } from './coordinator.js';
 import { ExpandHandler } from './expand.js';
 import { HistoryUpsertHandler } from './history-upsert.js';
 import { RagQueryHandler } from './rag-query.js';
@@ -25,7 +27,17 @@ export type StageHandlerRegistry = Map<string, IStageHandler>;
  * instances. All handlers are stateless — they read/write through the
  * {@link PipelineContext}.
  */
-export declare function buildDefaultHandlerRegistry(): StageHandlerRegistry;
+export interface BuildHandlerRegistryOptions {
+    subAgents?: SubAgentRegistry;
+    coordinator?: CoordinatorHandlerDeps;
+    /**
+     * Activation strategy used by the `coordinator-activate` runtime stage to
+     * compute `ctx.coordinatorActive`. Required when `coordinator` is set —
+     * without it, coordinator activation cannot honour runtime skill state.
+     */
+    coordinatorActivation?: IActivationStrategy;
+}
+export declare function buildDefaultHandlerRegistry(opts?: BuildHandlerRegistryOptions): StageHandlerRegistry;
 export { summarizeAndStore } from './history-upsert.js';
 export { AssembleHandler, BuildToolQueryHandler, ClassifyHandler, ExpandHandler, HistoryUpsertHandler, RagQueryHandler, RerankHandler, SkillSelectHandler, SummarizeHandler, ToolLoopHandler, ToolSelectHandler, TranslateHandler, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,oBAAoB,CAelE;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,mBAAmB,CAAC;CAC7C;AAED,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,2BAAgC,GACrC,oBAAoB,CA4BtB;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}

package/dist/pipeline/handlers/index.js

@@ -7,24 +7,20 @@
 import { AssembleHandler } from './assemble.js';
 import { BuildToolQueryHandler } from './build-tool-query.js';
 import { ClassifyHandler } from './classify.js';
+import { CoordinatorHandler, } from './coordinator.js';
+import { CoordinatorActivateHandler } from './coordinator-activate.js';
 import { ExpandHandler } from './expand.js';
 import { HistoryUpsertHandler } from './history-upsert.js';
 import { RagQueryHandler } from './rag-query.js';
 import { RerankHandler } from './rerank.js';
 import { SkillSelectHandler } from './skill-select.js';
+import { SubAgentHandler } from './subagent.js';
 import { SummarizeHandler } from './summarize.js';
 import { ToolLoopHandler } from './tool-loop.js';
 import { ToolSelectHandler } from './tool-select.js';
 import { TranslateHandler } from './translate.js';
-/**
- * Build the default handler registry with all built-in stage handlers.
- *
- * The registry maps stage type names (as used in YAML) to their handler
- * instances. All handlers are stateless — they read/write through the
- * {@link PipelineContext}.
- */
-export function buildDefaultHandlerRegistry() {
-    return new Map([
+export function buildDefaultHandlerRegistry(opts = {}) {
+    const registry = new Map([
         ['classify', new ClassifyHandler()],
         ['summarize', new SummarizeHandler()],
         ['translate', new TranslateHandler()],
@@ -38,6 +34,16 @@ export function buildDefaultHandlerRegistry() {
         ['tool-loop', new ToolLoopHandler()],
         ['history-upsert', new HistoryUpsertHandler()],
     ]);
+    if (opts.subAgents && opts.subAgents.size > 0) {
+        registry.set('subagent', new SubAgentHandler(opts.subAgents));
+    }
+    if (opts.coordinator) {
+        registry.set('coordinator', new CoordinatorHandler(opts.coordinator));
+    }
+    if (opts.coordinatorActivation) {
+        registry.set('coordinator-activate', new CoordinatorActivateHandler(opts.coordinatorActivation));
+    }
+    return registry;
 }
 export { summarizeAndStore } from './history-upsert.js';
 export { AssembleHandler, BuildToolQueryHandler, ClassifyHandler, ExpandHandler, HistoryUpsertHandler, RagQueryHandler, RerankHandler, SkillSelectHandler, SummarizeHandler, ToolLoopHandler, ToolSelectHandler, TranslateHandler, };

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlD;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,GAAG,CAAwB;QACpC,CAAC,UAAU,EAAE,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACrC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACrC,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QACpC,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC,cAAc,EAAE,IAAI,kBAAkB,EAAE,CAAC;QAC1C,CAAC,kBAAkB,EAAE,IAAI,qBAAqB,EAAE,CAAC;QACjD,CAAC,aAAa,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACxC,CAAC,UAAU,EAAE,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QACpC,CAAC,gBAAgB,EAAE,IAAI,oBAAoB,EAAE,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAsBlD,MAAM,UAAU,2BAA2B,CACzC,OAAoC,EAAE;IAEtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAwB;QAC9C,CAAC,UAAU,EAAE,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACrC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACrC,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QACpC,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC,cAAc,EAAE,IAAI,kBAAkB,EAAE,CAAC;QAC1C,CAAC,kBAAkB,EAAE,IAAI,qBAAqB,EAAE,CAAC;QACjD,CAAC,aAAa,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACxC,CAAC,UAAU,EAAE,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QACpC,CAAC,gBAAgB,EAAE,IAAI,oBAAoB,EAAE,CAAC;KAC/C,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC/B,QAAQ,CAAC,GAAG,CACV,sBAAsB,EACtB,IAAI,0BAA0B,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAC3D,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * SubAgentHandler — delegates a task to a named sub-agent from the registry.
+ *
+ * Reads:  `ctx.inputText` (default task template), `ctx.sessionId`, `ctx.options`
+ * Writes: `ctx.subResults.<agent>` (or custom path via `config.outputTo`)
+ *
+ * Stage config:
+ *   agent:    string  — registry key (required)
+ *   task:     string  — Handlebars-style template for the task; defaults to '{{inputText}}'
+ *   outputTo: string  — dot-path to write result output; defaults to `subResults.<agent>`
+ */
+import type { SubAgentRegistry } from '@mcp-abap-adt/llm-agent';
+import type { ISpan } from '../../tracer/types.js';
+import type { PipelineContext } from '../context.js';
+import type { IStageHandler } from '../stage-handler.js';
+export declare class SubAgentHandler implements IStageHandler {
+    private readonly registry;
+    constructor(registry: SubAgentRegistry);
+    execute(ctx: PipelineContext, rawConfig: Record<string, unknown>, _span: ISpan): Promise<boolean>;
+}
+//# sourceMappingURL=subagent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/pipeline/handlers/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD,qBAAa,eAAgB,YAAW,aAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAEjD,OAAO,CACX,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,OAAO,CAAC;CAyDpB"}

package/dist/pipeline/handlers/subagent.js

@@ -0,0 +1,58 @@
+/**
+ * SubAgentHandler — delegates a task to a named sub-agent from the registry.
+ *
+ * Reads:  `ctx.inputText` (default task template), `ctx.sessionId`, `ctx.options`
+ * Writes: `ctx.subResults.<agent>` (or custom path via `config.outputTo`)
+ *
+ * Stage config:
+ *   agent:    string  — registry key (required)
+ *   task:     string  — Handlebars-style template for the task; defaults to '{{inputText}}'
+ *   outputTo: string  — dot-path to write result output; defaults to `subResults.<agent>`
+ */
+import { OrchestratorError } from '../../agent.js';
+import { resolveTemplate, setPath } from '../../util/template.js';
+export class SubAgentHandler {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async execute(ctx, rawConfig, _span) {
+        const config = rawConfig;
+        if (!config.agent || typeof config.agent !== 'string') {
+            ctx.error = new OrchestratorError("subagent stage: 'agent' is required", 'SUBAGENT_CONFIG_ERROR');
+            return false;
+        }
+        const sub = this.registry.get(config.agent);
+        if (!sub) {
+            ctx.error = new OrchestratorError(`subagent '${config.agent}' not found. Registered: ${[...this.registry.keys()].join(', ') || '(none)'}`, 'SUBAGENT_NOT_FOUND');
+            return false;
+        }
+        const taskTemplate = config.task ?? '{{inputText}}';
+        const task = resolveTemplate(taskTemplate, ctx);
+        const signal = ctx.options?.signal;
+        let result;
+        try {
+            result = await sub.run({
+                task,
+                sessionId: ctx.sessionId,
+                signal,
+            });
+        }
+        catch (err) {
+            ctx.error = new OrchestratorError(err instanceof Error ? err.message : String(err), 'SUBAGENT_RUNTIME_ERROR');
+            return false;
+        }
+        const outputPath = config.outputTo ?? `subResults.${config.agent}`;
+        const ctxRecord = ctx;
+        if (!ctxRecord.subResults)
+            ctxRecord.subResults = {};
+        setPath(ctxRecord, outputPath, result.output);
+        ctx.options?.sessionLogger?.logStep(`subagent_${config.agent}`, {
+            task: task.slice(0, 200),
+            outputLength: result.output.length,
+            usage: result.usage,
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=subagent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../../src/pipeline/handlers/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAUlE,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAE3D,KAAK,CAAC,OAAO,CACX,GAAoB,EACpB,SAAkC,EAClC,KAAY;QAEZ,MAAM,MAAM,GAAG,SAA2C,CAAC;QAE3D,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtD,GAAG,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAC/B,qCAAqC,EACrC,uBAAuB,CACxB,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAA0B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAC/B,aAAa,MAAM,CAAC,KAAK,4BACvB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAC1C,EAAE,EACF,oBAAoB,CACrB,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,IAAI,eAAe,CAAC;QACpD,MAAM,IAAI,GAAG,eAAe,CAC1B,YAAY,EACZ,GAAyC,CAC1C,CAAC;QAEF,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;QACnC,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;gBACrB,IAAI;gBACJ,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAC/B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAChD,wBAAwB,CACzB,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC;QACnE,MAAM,SAAS,GAAG,GAAyC,CAAC;QAC5D,IAAI,CAAC,SAAS,CAAC,UAAU;YAAE,SAAS,CAAC,UAAU,GAAG,EAAE,CAAC;QACrD,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9C,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,EAAE;YAC9D,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+import type { ISubAgent, ISubAgentInput, ISubAgentResult } from '@mcp-abap-adt/llm-agent';
+import type { SmartAgent } from '../agent.js';
+export declare class SmartAgentSubAgent implements ISubAgent {
+    readonly name: string;
+    private readonly agent;
+    readonly description?: string;
+    constructor(name: string, agent: SmartAgent, opts?: {
+        description?: string;
+    });
+    run(input: ISubAgentInput): Promise<ISubAgentResult>;
+}
+//# sourceMappingURL=smart-agent-subagent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smart-agent-subagent.d.ts","sourceRoot":"","sources":["../../src/subagent/smart-agent-subagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,eAAe,EAEhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,kBAAmB,YAAW,SAAS;aAIhC,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;gBAGnB,IAAI,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EAClC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAK3B,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;CA+B3D"}

package/dist/subagent/smart-agent-subagent.js

@@ -0,0 +1,38 @@
+export class SmartAgentSubAgent {
+    name;
+    agent;
+    description;
+    constructor(name, agent, opts) {
+        this.name = name;
+        this.agent = agent;
+        this.description = opts?.description;
+    }
+    async run(input) {
+        const res = await this.agent.process(input.task, {
+            sessionId: input.sessionId,
+            signal: input.signal,
+        });
+        if (!res.ok) {
+            throw res.error;
+        }
+        const { content, toolCalls, usage } = res.value;
+        // Map SmartAgentResponse toolCalls (OpenAI wire format) → LlmToolCall[]
+        const mappedToolCalls = toolCalls?.map((tc) => ({
+            id: tc.id,
+            name: tc.function.name,
+            arguments: JSON.parse(tc.function.arguments),
+        }));
+        return {
+            output: content,
+            toolCalls: mappedToolCalls,
+            usage: usage
+                ? {
+                    promptTokens: usage.promptTokens,
+                    completionTokens: usage.completionTokens,
+                    totalTokens: usage.totalTokens,
+                }
+                : undefined,
+        };
+    }
+}
+//# sourceMappingURL=smart-agent-subagent.js.map

package/dist/subagent/smart-agent-subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-agent-subagent.js","sourceRoot":"","sources":["../../src/subagent/smart-agent-subagent.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,kBAAkB;IAIX;IACC;IAJH,WAAW,CAAU;IAErC,YACkB,IAAY,EACX,KAAiB,EAClC,IAA+B;QAFf,SAAI,GAAJ,IAAI,CAAQ;QACX,UAAK,GAAL,KAAK,CAAY;QAGlC,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAqB;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;YAC/C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,CAAC,KAAK,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC;QAEhD,wEAAwE;QACxE,MAAM,eAAe,GAA8B,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACzE,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;YACtB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAA4B;SACxE,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,KAAK;gBACV,CAAC,CAAC;oBACE,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;oBACxC,WAAW,EAAE,KAAK,CAAC,WAAW;iBAC/B;gBACH,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/util/template.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve `{{path.to.value}}` placeholders against a context object.
+ * Missing paths render as empty string. Non-string values are JSON-stringified.
+ */
+export declare function resolveTemplate(template: string, ctx: Record<string, unknown>): string;
+export declare function getPath(obj: unknown, path: string): unknown;
+export declare function setPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+//# sourceMappingURL=template.d.ts.map

package/dist/util/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/util/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAMR;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ3D;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAYN"}

package/dist/util/template.js

@@ -0,0 +1,36 @@
+/**
+ * Resolve `{{path.to.value}}` placeholders against a context object.
+ * Missing paths render as empty string. Non-string values are JSON-stringified.
+ */
+export function resolveTemplate(template, ctx) {
+    return template.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_, path) => {
+        const v = getPath(ctx, path);
+        if (v == null)
+            return '';
+        return typeof v === 'string' ? v : JSON.stringify(v);
+    });
+}
+export function getPath(obj, path) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+export function setPath(obj, path, value) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const next = cur[key];
+        if (next == null || typeof next !== 'object') {
+            cur[key] = {};
+        }
+        cur = cur[key];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+//# sourceMappingURL=template.js.map

package/dist/util/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/util/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,GAA4B;IAE5B,OAAO,QAAQ,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QACrE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI;YAAE,OAAO,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,IAAY;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7D,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,GAA4B,EAC5B,IAAY,EACZ,KAAc;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAA4B,GAAG,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,GAAG,GAAG,GAAG,CAAC,GAAG,CAA4B,CAAC;IAC5C,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/llm-agent-libs",
-  "version": "12.0.4",
+  "version": "12.1.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,9 +31,9 @@
     "test": "node --import tsx/esm --test --test-reporter=spec 'src/**/*.test.ts'"
   },
   "dependencies": {
-    "@mcp-abap-adt/llm-agent": "^12.0.4",
-    "@mcp-abap-adt/llm-agent-mcp": "^12.0.4",
-    "@mcp-abap-adt/llm-agent-rag": "^12.0.4",
+    "@mcp-abap-adt/llm-agent": "^12.1.0",
+    "@mcp-abap-adt/llm-agent-mcp": "^12.1.0",
+    "@mcp-abap-adt/llm-agent-rag": "^12.1.0",
     "@opentelemetry/api": "^1.9.1",
     "dotenv": "^17.3.1",
     "yaml": "^2.8.3",
@@ -60,10 +60,10 @@
     }
   },
   "devDependencies": {
-    "@mcp-abap-adt/openai-llm": "^12.0.4",
-    "@mcp-abap-adt/anthropic-llm": "^12.0.4",
-    "@mcp-abap-adt/deepseek-llm": "^12.0.4",
-    "@mcp-abap-adt/sap-aicore-llm": "^12.0.4"
+    "@mcp-abap-adt/openai-llm": "^12.1.0",
+    "@mcp-abap-adt/anthropic-llm": "^12.1.0",
+    "@mcp-abap-adt/deepseek-llm": "^12.1.0",
+    "@mcp-abap-adt/sap-aicore-llm": "^12.1.0"
   },
   "publishConfig": {
     "access": "public"