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

package/dist/factories/controller-factory.d.ts

@@ -0,0 +1,62 @@
+import type { BuiltCoordinator, CallOptions, IEmbedder, IKnowledgeRagHandle, IPipelineFactory, LlmTool, PipelineFactoryDepsBase } from '@mcp-abap-adt/llm-agent';
+import type { KnowledgeBackend } from '@mcp-abap-adt/llm-agent-libs';
+import type { ControllerConfig } from '../smart-agent/controller/types.js';
+/**
+ * Runtime dependencies for {@link ControllerFactory}. Like the Stepper factory
+ * deps, it extends {@link PipelineFactoryDepsBase} — the three controller roles
+ * ('evaluator' | 'planner' | 'executor') are resolved lazily via `makeRoleLlm`
+ * and wrapped into subagent clients by the factory — and adds the handler's
+ * run-time deps (knowledge backend/RAG, optional embedder, tool selection).
+ */
+export interface ControllerFactoryDeps extends PipelineFactoryDepsBase {
+    /** Durable knowledge backend (session bundle + episodic artifacts). */
+    backend: KnowledgeBackend;
+    /** Per-sessionId knowledge RAG factory. */
+    knowledgeRagFor: (sessionId: string) => IKnowledgeRagHandle | Promise<IKnowledgeRagHandle>;
+    /** ALWAYS required: results-RAG recall ranks by embedding similarity in every
+     *  persistence mode (and distance target-state, if used). `build()` throws when
+     *  absent — optional here only so the dep object can be assembled incrementally. */
+    embedder?: IEmbedder;
+    /** Semantic top-K tool selection over the vectorized MCP catalog. */
+    selectTools: (query: string, k?: number, options?: CallOptions) => Promise<readonly LlmTool[]>;
+    /** Optional override marking a tool as consumer-supplied (test-only). */
+    isExternalTool?: (toolName: string) => boolean;
+    /**
+     * Optional controller-own skills recall hook. When present, the planner queries
+     * it before each create-plan/replan and injects a bounded "Relevant skills"
+     * block into the prompt. The controller pipeline builds this from the skill
+     * plugin-host + configured group. Absent → the planner prompt is byte-identical
+     * to the agnostic path (the measurement toggle).
+     */
+    skillsRecall?: (goal: string, options?: CallOptions) => Promise<string>;
+}
+/**
+ * Builder-factory for the `controller` pipeline — the code-level (no-YAML)
+ * counterpart to the Stepper `*Factory` classes. Implements
+ * {@link IPipelineFactory} (`kind: 'controller'`): it resolves the three role
+ * LLMs via `makeRoleLlm`, wraps them as subagent clients, and assembles a
+ * {@link ControllerCoordinatorHandler}, returning a {@link BuiltCoordinator}
+ * (`{ handler }`) ready to attach via `builder.withStepperCoordinator(handler)`.
+ *
+ * @example
+ * ```ts
+ * import { ControllerFactory } from '@mcp-abap-adt/llm-agent-server-libs/controller';
+ * const { handler } = await new ControllerFactory().build(config, {
+ *   // role is typed as string by the base deps — resolve it explicitly. reviewer/
+ *   // finalizer are only requested when their subagent block is present; map them
+ *   // to config.subagents.reviewer ?? planner (likewise finalizer) for a 5-role config.
+ *   makeRoleLlm: (role) =>
+ *     makeLlm(
+ *       config.subagents[role as keyof typeof config.subagents] ??
+ *         config.subagents.planner,
+ *     ),
+ *   callMcp, backend, knowledgeRagFor, embedder, selectTools,
+ * });
+ * const handle = await builder.withStepperCoordinator(handler).build();
+ * ```
+ */
+export declare class ControllerFactory implements IPipelineFactory<ControllerConfig, ControllerFactoryDeps> {
+    readonly kind: "controller";
+    build(config: ControllerConfig, deps: ControllerFactoryDeps): Promise<BuiltCoordinator>;
+}
+//# sourceMappingURL=controller-factory.d.ts.map

package/dist/factories/controller-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-factory.d.ts","sourceRoot":"","sources":["../../src/factories/controller-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,uEAAuE;IACvE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,2CAA2C;IAC3C,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,KACd,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxD;;wFAEoF;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qEAAqE;IACrE,WAAW,EAAE,CACX,KAAK,EAAE,MAAM,EACb,CAAC,CAAC,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IACjC,yEAAyE;IACzE,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBACX,YAAW,gBAAgB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IAEpE,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IAEhC,KAAK,CACT,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;CAyE7B"}

package/dist/factories/controller-factory.js

@@ -0,0 +1,100 @@
+import { validateBoardBudget } from '../smart-agent/controller/board.js';
+import { ControllerCoordinatorHandler } from '../smart-agent/controller/controller-coordinator-handler.js';
+import { LlmFinalizer } from '../smart-agent/controller/finalizer.js';
+import { LlmReviewer } from '../smart-agent/controller/reviewer.js';
+import { makeSubagentClient } from '../smart-agent/controller/subagent-client.js';
+/**
+ * Builder-factory for the `controller` pipeline — the code-level (no-YAML)
+ * counterpart to the Stepper `*Factory` classes. Implements
+ * {@link IPipelineFactory} (`kind: 'controller'`): it resolves the three role
+ * LLMs via `makeRoleLlm`, wraps them as subagent clients, and assembles a
+ * {@link ControllerCoordinatorHandler}, returning a {@link BuiltCoordinator}
+ * (`{ handler }`) ready to attach via `builder.withStepperCoordinator(handler)`.
+ *
+ * @example
+ * ```ts
+ * import { ControllerFactory } from '@mcp-abap-adt/llm-agent-server-libs/controller';
+ * const { handler } = await new ControllerFactory().build(config, {
+ *   // role is typed as string by the base deps — resolve it explicitly. reviewer/
+ *   // finalizer are only requested when their subagent block is present; map them
+ *   // to config.subagents.reviewer ?? planner (likewise finalizer) for a 5-role config.
+ *   makeRoleLlm: (role) =>
+ *     makeLlm(
+ *       config.subagents[role as keyof typeof config.subagents] ??
+ *         config.subagents.planner,
+ *     ),
+ *   callMcp, backend, knowledgeRagFor, embedder, selectTools,
+ * });
+ * const handle = await builder.withStepperCoordinator(handler).build();
+ * ```
+ */
+export class ControllerFactory {
+    kind = 'controller';
+    async build(config, deps) {
+        // results-RAG recall is embedding-based in EVERY persistence mode → require an
+        // embedder AND a semantic-recall-capable backend. The embedder alone is not
+        // enough: a programmatic caller could pass an embedder PLUS a plain backend with
+        // no index, and recall would silently degrade to insertion order. Assert BOTH at
+        // the controller boundary, fail loud at build time.
+        if (!deps.embedder) {
+            throw new Error("pipeline 'controller' requires an embedder: results-RAG recall ranks by " +
+                'embedding similarity (and distance target-state, if used). Provide deps.embedder.');
+        }
+        if (!deps.backend.semanticRecallCapable) {
+            throw new Error("pipeline 'controller' requires a semantic-recall-capable knowledge backend " +
+                '(one built with an embedder-backed index); the injected backend reports ' +
+                'semanticRecallCapable=false, so recall would degrade to insertion order. ' +
+                'Build the backend via buildKnowledgeBackend (with a resolved embedder) or ' +
+                'inject a semantic-capable one.');
+        }
+        const b = config.budgets;
+        validateBoardBudget({
+            maxDigestChars: b.maxDigestChars ?? 500,
+            maxIntentChars: b.maxIntentChars ?? 120,
+            maxActiveSteps: b.maxActiveSteps ?? 16,
+            maxBoardChars: b.maxBoardChars ?? 12000,
+            keepRecentDigests: b.keepRecentDigests ?? 8,
+        });
+        const [evaluatorLlm, plannerLlm, executorLlm] = await Promise.all([
+            deps.makeRoleLlm('evaluator'),
+            deps.makeRoleLlm('planner'),
+            deps.makeRoleLlm('executor'),
+        ]);
+        // reviewer/finalizer default to the planner's LLM when their subagent config is
+        // absent (3-role config); the factory only resolves a distinct role LLM when the
+        // subagent block is present, so a 3-role config needs no resolver change.
+        const reviewerLlm = config.subagents.reviewer
+            ? await deps.makeRoleLlm('reviewer')
+            : plannerLlm;
+        const finalizerLlm = config.subagents.finalizer
+            ? await deps.makeRoleLlm('finalizer')
+            : plannerLlm;
+        const handler = new ControllerCoordinatorHandler({
+            evaluator: makeSubagentClient(evaluatorLlm),
+            planner: makeSubagentClient(plannerLlm),
+            executor: makeSubagentClient(executorLlm),
+            backend: deps.backend,
+            knowledgeRagFor: deps.knowledgeRagFor,
+            embedder: deps.embedder,
+            callMcp: (name, args) => deps.callMcp(name, args),
+            selectTools: deps.selectTools,
+            ...(deps.isExternalTool ? { isExternalTool: deps.isExternalTool } : {}),
+            ...(deps.skillsRecall ? { skillsRecall: deps.skillsRecall } : {}),
+            reviewer: new LlmReviewer(makeSubagentClient(reviewerLlm)),
+            finalizer: new LlmFinalizer(makeSubagentClient(finalizerLlm), {
+                budget: 12000,
+                perResultCap: 4000,
+            }),
+            config,
+            models: {
+                evaluator: evaluatorLlm.model ?? 'unknown',
+                planner: plannerLlm.model ?? 'unknown',
+                executor: executorLlm.model ?? 'unknown',
+                reviewer: reviewerLlm.model ?? 'unknown',
+                finalizer: finalizerLlm.model ?? 'unknown',
+            },
+        });
+        return { handler };
+    }
+}
+//# sourceMappingURL=controller-factory.js.map

package/dist/factories/controller-factory.js.map

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

package/dist/factories/cyclic-factory.d.ts

@@ -41,7 +41,7 @@ export declare function buildStepperCoordinator(spec: StepperCompositionSpec, de
  * Cyclic Stepper variant: no planner, a single cyclic-ReAct executor loop.
  * Preset: `{ planner: 'none', executor: 'cyclic-react' }`.
  */
-export declare class CyclicFactory implements IPipelineFactory<StepperFactoryConfig> {
+export declare class CyclicFactory implements IPipelineFactory<StepperFactoryConfig, StepperFactoryDeps> {
     readonly kind: "cyclic";
     build(config: StepperFactoryConfig, deps: StepperFactoryDeps): Promise<BuiltCoordinator>;
 }

package/dist/factories/cyclic-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cyclic-factory.d.ts","sourceRoot":"","sources":["../../src/factories/cyclic-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAG9C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,kEAAkE;IAClE,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrE,sDAAsD;IACtD,QAAQ,EAAE,eAAe,CAAC;IAC1B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,kCAAkC;IAClC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,qEAAqE;IACrE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,sBAAsB,EACtB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,gBAAgB,CAAC,oBAAoB,CAAC;IAC1E,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,KAAK,CACH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}
+{"version":3,"file":"cyclic-factory.d.ts","sourceRoot":"","sources":["../../src/factories/cyclic-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAG9C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,kEAAkE;IAClE,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrE,sDAAsD;IACtD,QAAQ,EAAE,eAAe,CAAC;IAC1B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,kCAAkC;IAClC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,qEAAqE;IACrE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,sBAAsB,EACtB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;AAED;;;GAGG;AACH,qBAAa,aACX,YAAW,gBAAgB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;IAErE,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,KAAK,CACH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}

package/dist/factories/cyclic-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"cyclic-factory.js","sourceRoot":"","sources":["../../src/factories/cyclic-factory.ts"],"names":[],"mappings":"AASA,OAAO,EACL,oBAAoB,GAErB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAmC1F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA4B,EAC5B,IAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC;QAC5C,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CACrC,oBAAoB,CAAC,IAAI,EAAE;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,EAAE;YACpC,UAAU;YACV,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;QACJ,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,QAAiB,CAAC;IAElC,KAAK,CACH,MAA4B,EAC5B,IAAwB;QAExB,OAAO,uBAAuB,CAC5B,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,EACxD,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"cyclic-factory.js","sourceRoot":"","sources":["../../src/factories/cyclic-factory.ts"],"names":[],"mappings":"AASA,OAAO,EACL,oBAAoB,GAErB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAmC1F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA4B,EAC5B,IAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC;QAC5C,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CACrC,oBAAoB,CAAC,IAAI,EAAE;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,EAAE;YACpC,UAAU;YACV,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;QACJ,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IAGf,IAAI,GAAG,QAAiB,CAAC;IAElC,KAAK,CACH,MAA4B,EAC5B,IAAwB;QAExB,OAAO,uBAAuB,CAC5B,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,EACxD,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}

package/dist/factories/deep-stepper-factory.d.ts

@@ -5,7 +5,7 @@ import { type StepperFactoryConfig, type StepperFactoryDeps } from './cyclic-fac
  * executor delegates sub-goals to child Steppers (subagents).
  * Preset: `{ planner: 'llm', executor: 'recursive' }`.
  */
-export declare class DeepStepperFactory implements IPipelineFactory<StepperFactoryConfig> {
+export declare class DeepStepperFactory implements IPipelineFactory<StepperFactoryConfig, StepperFactoryDeps> {
     readonly kind: "deep-stepper";
     build(config: StepperFactoryConfig, deps: StepperFactoryDeps): Promise<BuiltCoordinator>;
 }

package/dist/factories/deep-stepper-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-stepper-factory.d.ts","sourceRoot":"","sources":["../../src/factories/deep-stepper-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,qBAAa,kBACX,YAAW,gBAAgB,CAAC,oBAAoB,CAAC;IAEjD,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAExC,KAAK,CACH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}
+{"version":3,"file":"deep-stepper-factory.d.ts","sourceRoot":"","sources":["../../src/factories/deep-stepper-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,qBAAa,kBACX,YAAW,gBAAgB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;IAErE,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAExC,KAAK,CACH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}

package/dist/factories/index.d.ts

@@ -1,3 +1,5 @@
+export type { ControllerFactoryDeps } from './controller-factory.js';
+export { ControllerFactory } from './controller-factory.js';
 export type { StepperFactoryConfig, StepperFactoryDeps, } from './cyclic-factory.js';
 export { buildStepperCoordinator, CyclicFactory } from './cyclic-factory.js';
 export { DagFactory } from './dag-factory.js';

package/dist/factories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/factories/index.js

@@ -1,3 +1,4 @@
+export { ControllerFactory } from './controller-factory.js';
 export { buildStepperCoordinator, CyclicFactory } from './cyclic-factory.js';
 export { DagFactory } from './dag-factory.js';
 export { DeepStepperFactory } from './deep-stepper-factory.js';

package/dist/factories/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK5D,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/factories/planned-factory.d.ts

@@ -5,7 +5,7 @@ import { type StepperFactoryConfig, type StepperFactoryDeps } from './cyclic-fac
  * cyclic-ReAct executor runs each step.
  * Preset: `{ planner: 'llm', executor: 'cyclic-react' }`.
  */
-export declare class PlannedFactory implements IPipelineFactory<StepperFactoryConfig> {
+export declare class PlannedFactory implements IPipelineFactory<StepperFactoryConfig, StepperFactoryDeps> {
     readonly kind: "planned";
     build(config: StepperFactoryConfig, deps: StepperFactoryDeps): Promise<BuiltCoordinator>;
 }

package/dist/factories/planned-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planned-factory.d.ts","sourceRoot":"","sources":["../../src/factories/planned-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,qBAAa,cAAe,YAAW,gBAAgB,CAAC,oBAAoB,CAAC;IAC3E,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAEnC,KAAK,CACH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}
+{"version":3,"file":"planned-factory.d.ts","sourceRoot":"","sources":["../../src/factories/planned-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,qBAAa,cACX,YAAW,gBAAgB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;IAErE,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAEnC,KAAK,CACH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}

package/dist/factories/planned-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"planned-factory.js","sourceRoot":"","sources":["../../src/factories/planned-factory.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,GAGxB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,SAAkB,CAAC;IAEnC,KAAK,CACH,MAA4B,EAC5B,IAAwB;QAExB,OAAO,uBAAuB,CAC5B,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,EACvD,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"planned-factory.js","sourceRoot":"","sources":["../../src/factories/planned-factory.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,GAGxB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAGhB,IAAI,GAAG,SAAkB,CAAC;IAEnC,KAAK,CACH,MAA4B,EAC5B,IAAwB;QAExB,OAAO,uBAAuB,CAC5B,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,EACvD,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}

package/dist/generated/version.d.ts

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

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './smart-agent/build-dag-coordinator-deps.js';
 export * from './smart-agent/build-stepper-root.js';
 export * from './smart-agent/config.js';
 export * from './smart-agent/jsonl-knowledge-backend.js';
+export { makePgPool, makePgReadPool } from './smart-agent/pg-pool.js';
 export * from './smart-agent/pipeline.js';
 export * from './smart-agent/resolve-agent-embedder.js';
 export * from './smart-agent/session-identity-resolver.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,+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"}
+{"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,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACtE,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

@@ -4,6 +4,7 @@ export * from './smart-agent/build-dag-coordinator-deps.js';
 export * from './smart-agent/build-stepper-root.js';
 export * from './smart-agent/config.js';
 export * from './smart-agent/jsonl-knowledge-backend.js';
+export { makePgPool, makePgReadPool } from './smart-agent/pg-pool.js';
 export * from './smart-agent/pipeline.js';
 export * from './smart-agent/resolve-agent-embedder.js';
 export * from './smart-agent/session-identity-resolver.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,+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"}
+{"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,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACtE,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/pipelines/controller.d.ts

@@ -1,6 +1,7 @@
 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 { ControllerFactory, type ControllerFactoryDeps, } from '../factories/controller-factory.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';

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

@@ -1 +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"}
+{"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;AAKjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAM5E,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oCAAoC,CAAC;AAC5C,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;IA+CrC,KAAK,CACT,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,gCAAgC,GACpC,OAAO,CAAC,iBAAiB,CAAC;CAuE9B"}

package/dist/pipelines/controller.js

@@ -1,10 +1,10 @@
-import { ControllerCoordinatorHandler, } from '../smart-agent/controller/controller-coordinator-handler.js';
-import { makeSubagentClient } from '../smart-agent/controller/subagent-client.js';
+import { ControllerFactory, } from '../factories/controller-factory.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.
+// the coordinator in code — preferably via the `ControllerFactory`
+// (`const { handler } = await new ControllerFactory().build(config, deps)` then
+// `builder.withStepperCoordinator(handler)`), or directly with the handler.
+export { ControllerFactory, } from '../factories/controller-factory.js';
 export { ControllerCoordinatorHandler, } from '../smart-agent/controller/controller-coordinator-handler.js';
 export { makeSubagentClient, } from '../smart-agent/controller/subagent-client.js';
 /**
@@ -46,23 +46,16 @@ export class ControllerPipelinePlugin {
                 maxRetries: 3,
                 maxRewinds: 5,
                 maxToolCalls: 10,
+                maxDigestChars: 500,
+                maxIntentChars: 120,
+                maxActiveSteps: 16,
+                maxBoardChars: 12000,
+                keepRecentDigests: 8,
                 ...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
@@ -72,26 +65,55 @@ export class ControllerPipelinePlugin {
         // 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.
+        // Controller-OWN skills recall hook (B4). The controller pipeline builds its
+        // subagent prompts itself (it does NOT use the context-assembler), so it needs
+        // its own recall: query the configured controller skill group and format a
+        // bounded "Relevant skills" block the planner injects into create-plan/replan.
+        // Wired ONLY when a host AND a controller group are present; otherwise left
+        // undefined so the planner prompt stays byte-identical to the agnostic path.
+        // `controllerSkillGroup` is an INDEPENDENT channel from `serveCollections`
+        // (assembler pipelines); the group's existence is validated at startup, so we
+        // gate purely on host + group presence and do NOT couple to serveCollections.
+        const skillHost = ctx.skillHost;
+        const group = ctx.skillRecall?.controllerSkillGroup;
+        // Resolve the recall handle ONCE (the host memoises it anyway; this is the
+        // correct shape — no per-recall rag(group) lookup, and the wrapper's dimension/
+        // verdict cache is shared across recalls).
+        const skillRagHandle = skillHost && group ? skillHost.rag(group) : undefined;
+        const skillsRecall = skillRagHandle
+            ? async (goal, options) => {
+                const k = ctx.skillRecall?.k ?? 4;
+                const maxInjectChars = ctx.skillRecall?.maxInjectChars ?? 4000;
+                const queryOpts = ctx.skillRecall?.threshold !== undefined
+                    ? { k, threshold: ctx.skillRecall.threshold }
+                    : { k };
+                const hits = await skillRagHandle.query(goal, queryOpts, options);
+                if (hits.length === 0)
+                    return '';
+                let block = 'Relevant skills:\n';
+                for (const h of hits) {
+                    const next = `${block}- ${h.record.content}\n`;
+                    if (next.length > maxInjectChars)
+                        break;
+                    block = next;
+                }
+                return block.trimEnd();
+            }
+            : undefined;
+        // The factory resolves the three role LLMs via makeRoleLlm, wraps them as
+        // subagent clients, validates the embedder requirement, and builds the
+        // handler. external-tool routing is decided PER-REQUEST inside the handler
+        // from `ctx.externalTools`, so we do NOT wire `isExternalTool` here.
         const deps = {
-            evaluator: makeSubagentClient(evaluatorLlm),
-            planner: makeSubagentClient(plannerLlm),
-            executor: makeSubagentClient(executorLlm),
+            makeRoleLlm: (role) => ctx.makeLlm(cfg.subagents[role]),
+            callMcp: (name, args) => mcpBridge(name, args),
             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',
-            },
+            ...(skillsRecall ? { skillsRecall } : {}),
         };
-        const handler = new ControllerCoordinatorHandler(deps);
+        const { handler } = await new ControllerFactory().build(cfg, deps);
         const builder = await ctx.createAgentBuilder();
         const handle = await builder.withStepperCoordinator(handler).build();
         return { agent: handle.agent, close: () => handle.close() };

package/dist/pipelines/controller.js.map

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

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

@@ -1 +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"}
+{"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;AAIjC,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

@@ -1,5 +1,6 @@
 import { DagCoordinatorHandler } from '@mcp-abap-adt/llm-agent-libs';
 import { buildDagCoordinatorDeps } from '../smart-agent/build-dag-coordinator-deps.js';
+import { registerSkillSources } from './register-skill-sources.js';
 /**
  * Built-in `dag` pipeline plugin. Validates the raw DAG coordinator config
  * (requires a `planner`), assembles the coordinator deps via the shared
@@ -38,7 +39,7 @@ export class DagPipelinePlugin {
             throw new Error("pipeline 'dag': buildDagCoordinatorDeps returned undefined");
         }
         const handler = new DagCoordinatorHandler(deps);
-        const builder = await ctx.createAgentBuilder();
+        const builder = registerSkillSources(await ctx.createAgentBuilder(), ctx);
         const handle = await builder.withStepperCoordinator(handler).build();
         return { agent: handle.agent, close: () => handle.close() };
     }

package/dist/pipelines/dag.js.map

@@ -1 +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"}
+{"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;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAMnE;;;;;;;;;;;;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,oBAAoB,CAAC,MAAM,GAAG,CAAC,kBAAkB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1E,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.map

@@ -1 +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"}
+{"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;AAEjC,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

@@ -1,3 +1,4 @@
+import { registerSkillSources } from './register-skill-sources.js';
 /**
  * Built-in `flat` pipeline plugin. No coordinator — just builds a plain
  * {@link SmartAgent} with the base tool loop (no decomposition, planning, or
@@ -10,7 +11,7 @@ export class FlatPipelinePlugin {
         return {};
     }
     async build(_cfg, ctx) {
-        const builder = await ctx.createAgentBuilder();
+        const builder = registerSkillSources(await ctx.createAgentBuilder(), ctx);
         const handle = await builder.build();
         return { agent: handle.agent, close: () => handle.close() };
     }

package/dist/pipelines/flat.js.map

@@ -1 +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"}
+{"version":3,"file":"flat.js","sourceRoot":"","sources":["../../src/pipelines/flat.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE;;;;;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,oBAAoB,CAAC,MAAM,GAAG,CAAC,kBAAkB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1E,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.map

@@ -1 +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"}
+{"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;AAIjC,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

@@ -1,5 +1,6 @@
 import { LinearFactory } from '../factories/index.js';
 import { parseLinearConfig } from './parsers.js';
+import { registerSkillSources } from './register-skill-sources.js';
 /**
  * Built-in `linear` pipeline plugin. The raw config is resolved into
  * {@link CoordinatorHandlerDeps} (via {@link parseLinearConfig}) at build time
@@ -18,7 +19,7 @@ export class LinearPipelinePlugin {
             makeRoleLlm: (role) => ctx.resolveLlm(role),
             callMcp: (n, a, s) => ctx.callMcp(n, a, s).then(String),
         });
-        const builder = await ctx.createAgentBuilder();
+        const builder = registerSkillSources(await ctx.createAgentBuilder(), ctx);
         const handle = await builder.withStepperCoordinator(handler).build();
         return { agent: handle.agent, close: () => handle.close() };
     }

package/dist/pipelines/linear.js.map

@@ -1 +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"}
+{"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;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAMnE;;;;;;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,oBAAoB,CAAC,MAAM,GAAG,CAAC,kBAAkB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1E,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/register-skill-sources.d.ts

@@ -0,0 +1,21 @@
+import type { SmartAgentBuilder } from '@mcp-abap-adt/llm-agent-libs';
+import type { IServerPipelineContext } from './server-context.js';
+/**
+ * Implicit assembler wiring (B3): when a skill plugin-host is present on the
+ * context, register each served skill group's RAG handle as one more
+ * {@link skillsRagSource} `IRag` source on the agent builder. Called ONCE at
+ * build time by the assembler-based pipelines (flat/default, linear) — the
+ * serving collection set is fixed at host load.
+ *
+ * Absent `ctx.skillHost` this is a NO-OP (zero behavior change).
+ *
+ * Each group is registered under its own collection name so distinct groups do
+ * not collide in the RAG registry; all derive from the same `relevant-skills`
+ * base key so the assembler renders them under one "Relevant Skills" header
+ * family. Recall sizing (`k`/`threshold`) comes from `ctx.skillRecall`, threaded
+ * from the `skillPlugins:` host config.
+ *
+ * @returns the same builder (fluent), for call-site chaining.
+ */
+export declare function registerSkillSources(builder: SmartAgentBuilder, ctx: IServerPipelineContext): SmartAgentBuilder;
+//# sourceMappingURL=register-skill-sources.d.ts.map

package/dist/pipelines/register-skill-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-skill-sources.d.ts","sourceRoot":"","sources":["../../src/pipelines/register-skill-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAUlE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,sBAAsB,GAC1B,iBAAiB,CA+BnB"}