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

package/dist/smart-agent/controller/memorizer.d.ts

@@ -0,0 +1,6 @@
+import type { IKnowledgeRagHandle, KnowledgeEntryMetadata } from '@mcp-abap-adt/llm-agent';
+export interface Artifact extends KnowledgeEntryMetadata {
+    content: string;
+}
+export declare function writeArtifact(rag: IKnowledgeRagHandle, artifact: Artifact): Promise<void>;
+//# sourceMappingURL=memorizer.d.ts.map

package/dist/smart-agent/controller/memorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorizer.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/memorizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,QAAS,SAAQ,sBAAsB;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/smart-agent/controller/memorizer.js

@@ -0,0 +1,5 @@
+export async function writeArtifact(rag, artifact) {
+    const { content, ...metadata } = artifact;
+    await rag.write({ content, metadata });
+}
+//# sourceMappingURL=memorizer.js.map

package/dist/smart-agent/controller/memorizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorizer.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/memorizer.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAwB,EACxB,QAAkB;IAElB,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAC1C,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/smart-agent/controller/need-resolver.d.ts

@@ -0,0 +1,3 @@
+import type { IKnowledgeRagHandle, KnowledgeEntry, KnowledgeFilter } from '@mcp-abap-adt/llm-agent';
+export declare function resolveNeed(rag: IKnowledgeRagHandle, needText: string, k?: number, filter?: KnowledgeFilter): Promise<readonly KnowledgeEntry[]>;
+//# sourceMappingURL=need-resolver.d.ts.map

package/dist/smart-agent/controller/need-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"need-resolver.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/need-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,wBAAsB,WAAW,CAC/B,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,MAAM,EAChB,CAAC,SAAI,EACL,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAEpC"}

package/dist/smart-agent/controller/need-resolver.js

@@ -0,0 +1,4 @@
+export async function resolveNeed(rag, needText, k = 5, filter) {
+    return rag.query(needText, { k, filter });
+}
+//# sourceMappingURL=need-resolver.js.map

package/dist/smart-agent/controller/need-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"need-resolver.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/need-resolver.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAwB,EACxB,QAAgB,EAChB,CAAC,GAAG,CAAC,EACL,MAAwB;IAExB,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/smart-agent/controller/planner.d.ts

@@ -0,0 +1,34 @@
+import type { ISubagentClient } from './subagent-client.js';
+import type { IControllerPlanner, NextStep, PlannerKind, PlannerNextInput, SessionBundle } from './types.js';
+export declare class IncrementalPlanner implements IControllerPlanner {
+    private readonly planner;
+    /** Optional consumer domain hint appended to the agnostic planner prompt. */
+    private readonly hint?;
+    constructor(planner: ISubagentClient, 
+    /** Optional consumer domain hint appended to the agnostic planner prompt. */
+    hint?: string | undefined);
+    next(input: PlannerNextInput): Promise<NextStep | null>;
+}
+export declare class AdaptivePlanner implements IControllerPlanner {
+    private readonly planner;
+    /** Optional consumer domain hint appended to every agnostic planner/
+     *  create-plan/replan/finalize prompt this planner emits. */
+    private readonly hint?;
+    constructor(planner: ISubagentClient, 
+    /** Optional consumer domain hint appended to every agnostic planner/
+     *  create-plan/replan/finalize prompt this planner emits. */
+    hint?: string | undefined);
+    next(input: PlannerNextInput): Promise<NextStep | null>;
+    /** Commit the just-finished step's outcome so the advance is persisted with it.
+     *  On success the cursor moves to the next step; a failure leaves the cursor so
+     *  the next next() can replan from it. (No LLM call — pure bookkeeping.) */
+    commit(bundle: SessionBundle, outcome: 'advanced' | 'failed'): void;
+    /** Return the step at the cursor, or finalize → done when the plan is exhausted.
+     *  Returns null when the finalizer call fails (error / unexpected tool_call) so
+     *  the handler retries it (bounded by maxRetries) instead of emitting a fake
+     *  "completed" answer. */
+    private stepAtCursor;
+    private callPlan;
+}
+export declare function makePlanner(kind: PlannerKind, planner: ISubagentClient, hint?: string): IControllerPlanner;
+//# sourceMappingURL=planner.d.ts.map

package/dist/smart-agent/controller/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/planner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,aAAa,EAEd,MAAM,YAAY,CAAC;AAwBpB,qBAAa,kBAAmB,YAAW,kBAAkB;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAFL,OAAO,EAAE,eAAe;IACzC,6EAA6E;IAC5D,IAAI,CAAC,EAAE,MAAM,YAAA;IAG1B,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAiB9D;AAqFD,qBAAa,eAAgB,YAAW,kBAAkB;IAKtD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB;iEAC6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAHL,OAAO,EAAE,eAAe;IACzC;iEAC6D;IAC5C,IAAI,CAAC,EAAE,MAAM,YAAA;IAG1B,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IA8D7D;;gFAE4E;IAC5E,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI;IAMnE;;;8BAG0B;YACZ,YAAY;YAwBZ,QAAQ;CAgCvB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,MAAM,GACZ,kBAAkB,CAIpB"}

package/dist/smart-agent/controller/planner.js

@@ -0,0 +1,247 @@
+import { extractJsonObject, parseNextStep, } from './controller-coordinator-handler.js';
+import { appendHint } from './prompts.js';
+const PLANNER_SYSTEM = 'You are the planner. Given the goal and progress, return a SINGLE JSON ' +
+    'object: {"kind":"next","step":{"name":...,"instructions":...}} to take the ' +
+    'next step, {"kind":"done","result":...} when the goal is met, or ' +
+    '{"kind":"rewind","reason":...} to discard the current path. Output JSON only.\n' +
+    'An executor carries out each step against the live target system using tools. ' +
+    'Describe each step by INTENT — WHAT to fetch or do — in plain language. Do ' +
+    'NOT choose, name, or assume a specific tool (no tool names in the step); the ' +
+    'executor selects the right tool for the step. Any fact about the system MUST ' +
+    'be obtained by planning a step that fetches it with a tool — do NOT answer ' +
+    'from prior knowledge, and do NOT mark the goal "done" until the required data ' +
+    'has actually been fetched (fetched results appear under Progress). Until then, ' +
+    'return a concrete "next" fetch step. ' +
+    'Keep each step MINIMAL and do NOT broaden the scope beyond what the goal asks, ' +
+    'at the granularity it asks: a LIST/SHOW/find request is satisfied by the list ' +
+    'itself — do NOT plan a step that fetches the full details of every listed item ' +
+    'unless the goal explicitly asks for per-item details.';
+const RETRY_HINT = '\nIMPORTANT: your previous reply was NOT valid JSON. Reply with ONLY the raw ' +
+    'JSON object — no prose, no explanation, no markdown code fences.';
+export class IncrementalPlanner {
+    planner;
+    hint;
+    constructor(planner, 
+    /** Optional consumer domain hint appended to the agnostic planner prompt. */
+    hint) {
+        this.planner = planner;
+        this.hint = hint;
+    }
+    async next(input) {
+        const { bundle, prompt, retrying, logUsage } = input;
+        const res = await this.planner.send([
+            {
+                role: 'system',
+                content: appendHint(PLANNER_SYSTEM, this.hint) + (retrying ? RETRY_HINT : ''),
+            },
+            {
+                role: 'user',
+                content: `Goal: ${bundle.goal}\nProgress:${bundle.plannerPrivate}\nRequest: ${prompt}`,
+            },
+        ]);
+        logUsage?.('planner', res.usage);
+        if (res.kind !== 'content')
+            return null;
+        return parseNextStep(res.content);
+    }
+}
+const CREATE_PLAN_SYSTEM = 'You are the planner. Produce the COMPLETE, ordered plan that covers the ENTIRE ' +
+    'goal NOW, as a SINGLE JSON object: {"plan":[{"name":...,"instructions":...}, ...]}. ' +
+    'This is plan-once: there will be NO chance to add steps later (a replan happens ' +
+    'only if a step FAILS), so the plan MUST already contain every step the goal ' +
+    'needs from start to finish. Do NOT return a first-step-only or partial plan. ' +
+    'Decompose the whole goal: if the request lists multiple actions (e.g. joined by ' +
+    '"then"/"and"/"also"/"потім"/"і"/commas), emit ONE step per action — a ' +
+    'multi-action request MUST yield multiple steps (never a single step that lumps ' +
+    'them together). ' +
+    'Each step is ONE concrete action an executor performs against the live target ' +
+    'system using tools. Describe each step by INTENT — WHAT to fetch or do — in ' +
+    'plain language. Do NOT choose, name, or assume a specific tool (no tool names ' +
+    'in the step instructions); the executor selects the right tool for the step. ' +
+    'Any fact about the system MUST be fetched ' +
+    'with a tool — plan fetch steps; never answer from prior knowledge. ' +
+    'Keep it MINIMAL: one step per distinct piece of information the goal asks for; ' +
+    'do NOT add exploratory or enrichment steps (extra metadata, sample/preview ' +
+    'rows, recursive expansion) the goal did not request. ' +
+    'Do NOT BROADEN the scope: answer exactly what the request asks, at the ' +
+    'granularity it asks. In particular, do NOT add a "for each item, fetch its ' +
+    'details" step unless the request explicitly asks for per-item details — a ' +
+    'request to LIST/SHOW/find items is satisfied by the list itself; fetching the ' +
+    'full details of every listed item is scope creep. ' +
+    'Do NOT add a final step ' +
+    'that summarizes, formats, or answers the user — a separate finalizer composes ' +
+    'the answer from the fetched results, so the last step must be the last ' +
+    'data-fetch/action the goal needs. Output JSON only.';
+const REPLAN_SYSTEM = 'You are the planner. A step just FAILED. Given the goal, the progress so far ' +
+    '(fetched results + the failure), produce a REVISED, MINIMAL plan for the ' +
+    'REMAINING work as {"plan":[{"name":...,"instructions":...}, ...]}. Plan only ' +
+    'the data-fetch/action steps still required; describe each step by INTENT — do ' +
+    'NOT name or choose a specific tool, the executor selects it. Do NOT add a ' +
+    'final summarize/' +
+    'answer step (a separate finalizer composes the answer). If the goal is ' +
+    'already satisfied despite the failure, return {"plan":[]}. Output JSON only.';
+const EXTERNAL_RESULT_REPLAN_SYSTEM = 'You are the planner. A NEW external tool result just arrived (see Progress) — ' +
+    'this is NOT a failure. Given the goal and the progress (including the new ' +
+    'result), produce a REVISED, MINIMAL plan for the REMAINING work as ' +
+    '{"plan":[{"name":...,"instructions":...}, ...]}. Plan only the data-fetch/' +
+    'action steps still required; describe each step by INTENT — do NOT name or ' +
+    'choose a specific tool, the executor selects it. Do NOT add a final summarize/' +
+    'answer step (a ' +
+    'separate finalizer composes the answer). If the goal is already satisfied by ' +
+    'the result, return {"plan":[]}. Output JSON only.';
+const FINALIZE_SYSTEM = 'All planned steps are complete. Using the progress below (the fetched results), ' +
+    'write the final answer to the user request. Plain text, no JSON.';
+/** Parse {"plan":[{name,instructions},...]} from a (possibly fenced) reply.
+ *  Returns null on format failure: no `plan` array, OR ANY entry missing a valid
+ *  name/instructions (so a half-formed step is a retryable format error, not a
+ *  silently-dropped step). An explicitly empty `{"plan":[]}` is VALID (= nothing
+ *  left to do — used by replan to signal completion). */
+function parsePlan(content) {
+    const json = extractJsonObject(content);
+    if (json === null)
+        return null;
+    try {
+        const obj = JSON.parse(json);
+        if (!Array.isArray(obj.plan))
+            return null;
+        const steps = [];
+        for (const raw of obj.plan) {
+            const s = raw;
+            if (typeof s.name !== 'string' || typeof s.instructions !== 'string') {
+                return null; // malformed step → format failure (handler retries)
+            }
+            steps.push({
+                name: s.name,
+                instructions: s.instructions,
+                ...(s.type ? { type: s.type } : {}),
+            });
+        }
+        return steps;
+    }
+    catch {
+        return null;
+    }
+}
+export class AdaptivePlanner {
+    planner;
+    hint;
+    // No budget field: replans are bounded by the loop's maxSteps (a failed step
+    // bumps stepsUsed in runStep). Replan-specific budgeting is the deferred
+    // "limits as a selectable strategy" work.
+    constructor(planner, 
+    /** Optional consumer domain hint appended to every agnostic planner/
+     *  create-plan/replan/finalize prompt this planner emits. */
+    hint) {
+        this.planner = planner;
+        this.hint = hint;
+    }
+    async next(input) {
+        const { bundle, prompt, lastOutcome, resumedExternal, retrying, logUsage } = input;
+        // 1. No plan yet → create it.
+        if (!bundle.plan) {
+            const plan = await this.callPlan(CREATE_PLAN_SYSTEM, bundle, prompt, retrying, logUsage);
+            // An EMPTY plan from createPlan is invalid: it would skip straight to the
+            // finalizer and answer WITHOUT fetching the required data. Treat it as a
+            // format failure → handler re-asks (bounded by maxRetries). (An empty plan
+            // is only valid on REPLAN, where it means "remaining work is done".)
+            if (plan === null || plan.length === 0)
+                return null;
+            bundle.plan = plan;
+            bundle.planCursor = 0;
+            return this.stepAtCursor(bundle, prompt, logUsage);
+        }
+        // 2. Previous step failed, OR an external-tool result just arrived → replan
+        //    the remainder from the cursor. The planner reads plannerPrivate (which
+        //    now holds the failure/external result), so the revised plan incorporates
+        //    it — no reliance on the executor seeing it. Use the matching prompt: an
+        //    external result is NOT a failure, so it gets its own framing.
+        if (lastOutcome === 'failed' || resumedExternal) {
+            const system = resumedExternal
+                ? EXTERNAL_RESULT_REPLAN_SYSTEM
+                : REPLAN_SYSTEM;
+            const cursor = bundle.planCursor ?? 0;
+            // Steps before the cursor already ran successfully — pass them so the replan
+            // plans only the remaining work and never repeats a completed step.
+            const completed = bundle.plan.slice(0, cursor);
+            const rest = await this.callPlan(system, bundle, prompt, retrying, logUsage, completed);
+            if (rest === null)
+                return null;
+            bundle.plan = [...bundle.plan.slice(0, cursor), ...rest];
+            // The failure has now been consumed into the revised plan. Clear the durable
+            // failure marker BEFORE the (possible) finalize below, so that: a crash after
+            // this replan does NOT replan again on resume, and a finalizer error after an
+            // empty replan retries only the finalizer (not another replan).
+            bundle.lastOutcome = undefined;
+            return this.stepAtCursor(bundle, prompt, logUsage);
+        }
+        // 3. Otherwise emit the step at the cursor (or finalize). The cursor is
+        //    advanced by commit() AFTER a step succeeds — NOT here — so the advance
+        //    is persisted together with the step result (see Task 4), and a resume
+        //    with lastOutcome=undefined continues from the next uncompleted step
+        //    instead of repeating the last one.
+        return this.stepAtCursor(bundle, prompt, logUsage);
+    }
+    /** Commit the just-finished step's outcome so the advance is persisted with it.
+     *  On success the cursor moves to the next step; a failure leaves the cursor so
+     *  the next next() can replan from it. (No LLM call — pure bookkeeping.) */
+    commit(bundle, outcome) {
+        if (outcome === 'advanced') {
+            bundle.planCursor = (bundle.planCursor ?? 0) + 1;
+        }
+    }
+    /** Return the step at the cursor, or finalize → done when the plan is exhausted.
+     *  Returns null when the finalizer call fails (error / unexpected tool_call) so
+     *  the handler retries it (bounded by maxRetries) instead of emitting a fake
+     *  "completed" answer. */
+    async stepAtCursor(bundle, prompt, logUsage) {
+        const plan = bundle.plan ?? [];
+        const cursor = bundle.planCursor ?? 0;
+        if (cursor >= plan.length) {
+            const res = await this.planner.send([
+                { role: 'system', content: appendHint(FINALIZE_SYSTEM, this.hint) },
+                {
+                    role: 'user',
+                    content: `Goal: ${bundle.goal}\nRequest: ${prompt}\nProgress:${bundle.plannerPrivate}`,
+                },
+            ]);
+            logUsage?.('finalizer', res.usage);
+            // Finalizer must produce content; an error or tool_call is NOT a successful
+            // answer → null so the handler re-asks rather than faking "completed".
+            if (res.kind !== 'content')
+                return null;
+            return { kind: 'done', result: res.content };
+        }
+        return { kind: 'next', step: plan[cursor] };
+    }
+    async callPlan(system, bundle, prompt, retrying, logUsage, completed = []) {
+        // On replan, the planner MUST know which steps already ran (their results are
+        // in Progress / the step-result collection) so it plans ONLY the remaining
+        // work and never re-executes a completed step.
+        const completedBlock = completed.length
+            ? `\nALREADY-EXECUTED steps — their results are in Progress above; do NOT plan or repeat these, plan only what is still missing:\n${completed.map((s) => `- ${s.name}`).join('\n')}`
+            : '';
+        const res = await this.planner.send([
+            {
+                role: 'system',
+                content: appendHint(system, this.hint) +
+                    (retrying
+                        ? '\nIMPORTANT: your previous reply was NOT valid JSON. Reply with ONLY the raw JSON object.'
+                        : ''),
+            },
+            {
+                role: 'user',
+                content: `Goal: ${bundle.goal}\nProgress:${bundle.plannerPrivate}${completedBlock}\nRequest: ${prompt}`,
+            },
+        ]);
+        logUsage?.('planner', res.usage);
+        if (res.kind !== 'content')
+            return null;
+        return parsePlan(res.content);
+    }
+}
+export function makePlanner(kind, planner, hint) {
+    return kind === 'adaptive'
+        ? new AdaptivePlanner(planner, hint)
+        : new IncrementalPlanner(planner, hint);
+}
+//# sourceMappingURL=planner.js.map

package/dist/smart-agent/controller/planner.js.map

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

package/dist/smart-agent/controller/prompts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Append an optional per-role hint to a role's agnostic system prompt.
+ *
+ * The controller engine's role prompts (evaluator / planner / executor) are
+ * deliberately AGNOSTIC and concise. A deployment can append extra OPERATIONAL
+ * guidance for a role via `subagents.<role>.hint` — how to build the plan, how
+ * to execute a step, what to be strict about. Its main purpose is to scaffold
+ * WEAKER models: a capable model (Opus / Sonnet) usually needs none, while a
+ * smaller executor/planner model (e.g. gpt-4o-mini) may need the extra steering.
+ *
+ * A hint is NOT a domain description and must NOT name tools: the planner plans
+ * by intent (no tool catalog) and the executor selects the right tool per step;
+ * richer per-situation procedures belong to the skills RAG — a separate, dynamic
+ * mechanism. An absent or blank hint leaves the agnostic prompt untouched.
+ */
+export declare function appendHint(system: string, hint?: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/smart-agent/controller/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/smart-agent/controller/prompts.js

@@ -0,0 +1,20 @@
+/**
+ * Append an optional per-role hint to a role's agnostic system prompt.
+ *
+ * The controller engine's role prompts (evaluator / planner / executor) are
+ * deliberately AGNOSTIC and concise. A deployment can append extra OPERATIONAL
+ * guidance for a role via `subagents.<role>.hint` — how to build the plan, how
+ * to execute a step, what to be strict about. Its main purpose is to scaffold
+ * WEAKER models: a capable model (Opus / Sonnet) usually needs none, while a
+ * smaller executor/planner model (e.g. gpt-4o-mini) may need the extra steering.
+ *
+ * A hint is NOT a domain description and must NOT name tools: the planner plans
+ * by intent (no tool catalog) and the executor selects the right tool per step;
+ * richer per-situation procedures belong to the skills RAG — a separate, dynamic
+ * mechanism. An absent or blank hint leaves the agnostic prompt untouched.
+ */
+export function appendHint(system, hint) {
+    const h = hint?.trim();
+    return h ? `${system}\n\nAdditional guidance: ${h}` : system;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/smart-agent/controller/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,IAAa;IACtD,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IACvB,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,4BAA4B,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC"}

package/dist/smart-agent/controller/session-bundle.d.ts

@@ -0,0 +1,15 @@
+import type { KnowledgeBackend } from '@mcp-abap-adt/llm-agent-libs';
+import type { SessionBundle } from './types.js';
+/**
+ * Durably persist the session bundle into the KnowledgeBackend, keyed by
+ * sessionId. Uses artifactType 'controller-bundle' as the discriminator.
+ * Required metadata fields are filled with deterministic synthetic values
+ * since this is an infrastructure record, not a turn-scoped artifact.
+ */
+export declare function persistBundle(be: KnowledgeBackend, sessionId: string, bundle: SessionBundle): Promise<void>;
+/**
+ * Retrieve the latest persisted bundle for a session. Returns a fresh empty
+ * bundle if none exists or if the stored content cannot be parsed.
+ */
+export declare function hydrateBundle(be: KnowledgeBackend, sessionId: string): Promise<SessionBundle>;
+//# sourceMappingURL=session-bundle.d.ts.map

package/dist/smart-agent/controller/session-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bundle.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/session-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkBhD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,gBAAgB,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,gBAAgB,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAaxB"}

package/dist/smart-agent/controller/session-bundle.js

@@ -0,0 +1,53 @@
+const BUNDLE_ARTIFACT_TYPE = 'controller-bundle';
+const EMPTY_BUNDLE = {
+    goal: '',
+    plannerPrivate: '',
+    budgets: { stepsUsed: 0, rewindsUsed: 0 },
+};
+function emptyBundle() {
+    return {
+        goal: EMPTY_BUNDLE.goal,
+        plannerPrivate: EMPTY_BUNDLE.plannerPrivate,
+        budgets: { ...EMPTY_BUNDLE.budgets },
+    };
+}
+/**
+ * Durably persist the session bundle into the KnowledgeBackend, keyed by
+ * sessionId. Uses artifactType 'controller-bundle' as the discriminator.
+ * Required metadata fields are filled with deterministic synthetic values
+ * since this is an infrastructure record, not a turn-scoped artifact.
+ */
+export async function persistBundle(be, sessionId, bundle) {
+    await be.put(sessionId, {
+        content: JSON.stringify(bundle),
+        metadata: {
+            traceId: sessionId,
+            turnId: sessionId,
+            stepperId: 'controller',
+            task: 'session-bundle',
+            artifactType: BUNDLE_ARTIFACT_TYPE,
+            createdAt: new Date().toISOString(),
+        },
+    });
+}
+/**
+ * Retrieve the latest persisted bundle for a session. Returns a fresh empty
+ * bundle if none exists or if the stored content cannot be parsed.
+ */
+export async function hydrateBundle(be, sessionId) {
+    const entries = await be.scan(sessionId);
+    // Scan returns oldest-first; iterate in reverse so the latest bundle wins.
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.metadata.artifactType !== BUNDLE_ARTIFACT_TYPE)
+            continue;
+        try {
+            return JSON.parse(entry.content);
+        }
+        catch {
+            // malformed entry — keep scanning backwards for a valid one
+        }
+    }
+    return emptyBundle();
+}
+//# sourceMappingURL=session-bundle.js.map

package/dist/smart-agent/controller/session-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bundle.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/session-bundle.ts"],"names":[],"mappings":"AAGA,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEjD,MAAM,YAAY,GAAkB;IAClC,IAAI,EAAE,EAAE;IACR,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;CAC1C,CAAC;AAEF,SAAS,WAAW;IAClB,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,cAAc,EAAE,YAAY,CAAC,cAAc;QAC3C,OAAO,EAAE,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE;KACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAoB,EACpB,SAAiB,EACjB,MAAqB;IAErB,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE;QACtB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAC/B,QAAQ,EAAE;YACR,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,YAAY;YACvB,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE,oBAAoB;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAoB,EACpB,SAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,2EAA2E;IAC3E,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,KAAK,oBAAoB;YAAE,SAAS;QACnE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ILlm, LlmTool, Message } from '@mcp-abap-adt/llm-agent';
+import type { SubagentResult } from './types.js';
+export interface ISubagentClient {
+    send(messages: Message[], tools?: LlmTool[]): Promise<SubagentResult>;
+}
+export declare function makeSubagentClient(llm: ILlm): ISubagentClient;
+//# sourceMappingURL=subagent-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-client.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/subagent-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,eAAe,CAgB7D"}

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

@@ -0,0 +1,18 @@
+export function makeSubagentClient(llm) {
+    return {
+        async send(messages, tools) {
+            const r = await llm.chat(messages, tools);
+            if (!r.ok)
+                return {
+                    kind: 'error',
+                    error: r.error?.message ?? 'subagent llm error',
+                };
+            const v = r.value;
+            const usage = v.usage ? { usage: v.usage } : {};
+            if (v.toolCalls && v.toolCalls.length > 0)
+                return { kind: 'tool_call', toolCalls: v.toolCalls, ...usage };
+            return { kind: 'content', content: v.content ?? '', ...usage };
+        },
+    };
+}
+//# sourceMappingURL=subagent-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-client.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/subagent-client.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAAC,GAAS;IAC1C,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK;YACxB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,CAAC,CAAC,EAAE;gBACP,OAAO;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,oBAAoB;iBAChD,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAClB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBACvC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;YACjE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/smart-agent/controller/target-state.d.ts

@@ -0,0 +1,28 @@
+import type { CallOptions, IEmbedder, LlmUsage } from '@mcp-abap-adt/llm-agent';
+import type { ISubagentClient } from './subagent-client.js';
+import type { ControllerConfig } from './types.js';
+export interface TargetStateDeps {
+    evaluator: ISubagentClient;
+    /** Required only for distance strategies (semantic-distance/auto). */
+    embedder?: IEmbedder;
+}
+/**
+ * Outcome of establishing the target state. `established` → the goal is settled
+ * and the loop proceeds. `needs-confirmation` → the coordinator must ask the
+ * consumer to confirm/refine `proposedTarget` (the marker carries it so a plain
+ * "yes" on resume commits the proposed target rather than the literal answer).
+ */
+export type TargetStateOutcome = {
+    kind: 'established';
+    goal: string;
+    usage?: LlmUsage;
+} | {
+    kind: 'needs-confirmation';
+    proposedTarget: string;
+    question: string;
+    usage?: LlmUsage;
+};
+export declare function establishTargetState(deps: TargetStateDeps, prompt: string, cfg: ControllerConfig['targetState'], options?: CallOptions, 
+/** Optional consumer domain hint appended to the agnostic evaluator prompt. */
+hint?: string): Promise<TargetStateOutcome>;
+//# sourceMappingURL=target-state.d.ts.map

package/dist/smart-agent/controller/target-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-state.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/target-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,eAAe,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GACvD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAgBN,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,gBAAgB,CAAC,aAAa,CAAC,EACpC,OAAO,CAAC,EAAE,WAAW;AACrB,+EAA+E;AAC/E,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,CAgD7B"}

package/dist/smart-agent/controller/target-state.js

@@ -0,0 +1,59 @@
+import { appendHint } from './prompts.js';
+function cosineDistance(a, b) {
+    const n = Math.min(a.length, b.length);
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < n; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    if (na === 0 || nb === 0)
+        return 1;
+    return 1 - dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+export async function establishTargetState(deps, prompt, cfg, options, 
+/** Optional consumer domain hint appended to the agnostic evaluator prompt. */
+hint) {
+    const r = await deps.evaluator.send([
+        {
+            role: 'system',
+            content: appendHint('Restate the user request as a SHORT objective — the target state to ' +
+                'achieve — in one or two sentences. Do NOT answer the request, and do ' +
+                'NOT include any data, results, code, or explanations. Output only the ' +
+                'objective.', hint),
+        },
+        { role: 'user', content: prompt },
+    ]);
+    const target = r.kind === 'content' ? r.content : '';
+    if (cfg.strategy === 'consumer-confirm') {
+        return {
+            kind: 'needs-confirmation',
+            proposedTarget: target,
+            question: `Confirm or refine the target state:\n${target}`,
+            usage: r.usage,
+        };
+    }
+    // MVP: 'auto' currently behaves as 'semantic-distance' (evaluator-self-judging is a follow-up).
+    if (cfg.strategy === 'semantic-distance' || cfg.strategy === 'auto') {
+        if (!deps.embedder) {
+            throw new Error(`target-state strategy '${cfg.strategy}' requires an embedder; configure rag.embedder or use strategy: consumer-confirm`);
+        }
+        const [te, pe] = await Promise.all([
+            deps.embedder.embed(target, options),
+            deps.embedder.embed(prompt, options),
+        ]);
+        const dist = cosineDistance(te.vector, pe.vector);
+        if (dist > cfg.distanceThreshold) {
+            return {
+                kind: 'needs-confirmation',
+                proposedTarget: target,
+                question: `The goal may be ambiguous (distance ${dist.toFixed(2)}). Confirm or refine:\n${target}`,
+                usage: r.usage,
+            };
+        }
+    }
+    return { kind: 'established', goal: target, usage: r.usage };
+}
+//# sourceMappingURL=target-state.js.map

package/dist/smart-agent/controller/target-state.js.map

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