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

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

@@ -1,6 +1,21 @@
+import { mintCreateStepIds, mintReplanStepIds, } from './artifacts.js';
 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 ' +
+import { MAX_REQUIRE_CHARS, MAX_REQUIRES, validateRequires, } from './types.js';
+// Built from the validation constants so the prompt cap can NEVER drift from what
+// the parser enforces (no duplicated literals). Appended to EVERY planner/replan
+// prompt as a HARD invariant so step instructions/requires are English (stable
+// tool selection against the English-translated catalog) and the requires count is
+// bounded.
+export const ENGLISH_INSTRUCTIONS_RULE = ' Step `instructions` AND `requires` references MUST be written in English — ' +
+    "always, regardless of the language of the user's request. This is a hard " +
+    'contract: the executor selects tools by semantic match against an ' +
+    'English-translated catalog, and the reviewer matches `requires` against stored ' +
+    'artifacts — so non-English instructions/requires break both. ' +
+    `List at MOST ${MAX_REQUIRES} \`requires\`, each a SHORT reference (a few words, ` +
+    `≤ ${MAX_REQUIRE_CHARS} chars) — not pasted content. (The user-facing answer is ` +
+    "composed separately in the user's language.)";
+export 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' +
@@ -15,20 +30,43 @@ const PLANNER_SYSTEM = 'You are the planner. Given the goal and progress, return
     '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.';
+    'unless the goal explicitly asks for per-item details.' +
+    ENGLISH_INSTRUCTIONS_RULE;
 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.';
+/** Append a non-empty recall block to a user message, preserving the agnostic
+ *  message byte-for-byte when the block is empty. */
+function withSkillsBlock(userContent, block) {
+    return block ? `${userContent}\n\n${block}` : userContent;
+}
+/** The planner's progress context. With a live board, render the AUTHORITATIVE
+ *  structured board AND the plannerPrivate tail — the latter carries non-board
+ *  deltas the planner still needs (clarify answers, legacy external-tool result).
+ *  An empty board (decision-less IncrementalPlanner) → plannerPrivate alone,
+ *  byte-identical to the legacy prompt. */
+function progressBlock(bundle, boardText) {
+    return boardText && boardText.length > 0
+        ? `${boardText}\n${bundle.plannerPrivate}`
+        : bundle.plannerPrivate;
+}
 export class IncrementalPlanner {
     planner;
     hint;
+    skillsRecall;
     constructor(planner, 
     /** Optional consumer domain hint appended to the agnostic planner prompt. */
-    hint) {
+    hint, 
+    /** Optional controller-own skills recall hook (B4). */
+    skillsRecall) {
         this.planner = planner;
         this.hint = hint;
+        this.skillsRecall = skillsRecall;
     }
     async next(input) {
-        const { bundle, prompt, retrying, logUsage } = input;
+        const { bundle, prompt, retrying, logUsage, options, boardText } = input;
+        const block = this.skillsRecall
+            ? await this.skillsRecall(bundle.goal, options)
+            : '';
         const res = await this.planner.send([
             {
                 role: 'system',
@@ -36,7 +74,7 @@ export class IncrementalPlanner {
             },
             {
                 role: 'user',
-                content: `Goal: ${bundle.goal}\nProgress:${bundle.plannerPrivate}\nRequest: ${prompt}`,
+                content: withSkillsBlock(`Goal: ${bundle.goal}\nProgress:${progressBlock(bundle, boardText)}\nRequest: ${prompt}`, block),
             },
         ]);
         logUsage?.('planner', res.usage);
@@ -45,7 +83,7 @@ export class IncrementalPlanner {
         return parseNextStep(res.content);
     }
 }
-const CREATE_PLAN_SYSTEM = 'You are the planner. Produce the COMPLETE, ordered plan that covers the ENTIRE ' +
+export 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 ' +
@@ -71,16 +109,18 @@ const CREATE_PLAN_SYSTEM = 'You are the planner. Produce the COMPLETE, ordered p
     '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 ' +
+    'data-fetch/action the goal needs. Output JSON only.' +
+    ENGLISH_INSTRUCTIONS_RULE;
+export 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) — ' +
+    'already satisfied despite the failure, return {"plan":[]}. Output JSON only.' +
+    ENGLISH_INSTRUCTIONS_RULE;
+export 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/' +
@@ -88,7 +128,8 @@ const EXTERNAL_RESULT_REPLAN_SYSTEM = 'You are the planner. A NEW external tool
     '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.';
+    'the result, return {"plan":[]}. Output JSON only.' +
+    ENGLISH_INSTRUCTIONS_RULE;
 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.
@@ -110,10 +151,14 @@ function parsePlan(content) {
             if (typeof s.name !== 'string' || typeof s.instructions !== 'string') {
                 return null; // malformed step → format failure (handler retries)
             }
+            const req = validateRequires(raw.requires);
+            if (req === false)
+                return null; // malformed requires → format failure → retry
             steps.push({
                 name: s.name,
                 instructions: s.instructions,
                 ...(s.type ? { type: s.type } : {}),
+                ...(req ? { requires: req } : {}),
             });
         }
         return steps;
@@ -122,40 +167,60 @@ function parsePlan(content) {
         return null;
     }
 }
+/** Queue a plan decision for the controller to persist (§A boundary: the planner
+ *  CONSTRUCTS the decision; the controller does the durable write). */
+function recordDecision(bundle, decision) {
+    if (!bundle.pendingPlanDecisions)
+        bundle.pendingPlanDecisions = [];
+    bundle.pendingPlanDecisions.push(decision);
+}
 export class AdaptivePlanner {
     planner;
     hint;
+    skillsRecall;
     // 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) {
+    hint, 
+    /** Optional controller-own skills recall hook (B4). Queried before each
+     *  create-plan/replan; its block is injected into the user message. */
+    skillsRecall) {
         this.planner = planner;
         this.hint = hint;
+        this.skillsRecall = skillsRecall;
     }
     async next(input) {
-        const { bundle, prompt, lastOutcome, resumedExternal, retrying, logUsage } = input;
+        const { bundle, prompt, lastOutcome, resumedExternal, retrying, logUsage, options, boardText, } = input;
         // 1. No plan yet → create it.
         if (!bundle.plan) {
-            const plan = await this.callPlan(CREATE_PLAN_SYSTEM, bundle, prompt, retrying, logUsage);
+            const plan = await this.callPlan(CREATE_PLAN_SYSTEM, bundle, prompt, retrying, logUsage, [], options, boardText);
             // 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;
+            const minted = mintCreateStepIds(plan, bundle.runId ?? '');
+            bundle.plan = minted;
             bundle.planCursor = 0;
-            return this.stepAtCursor(bundle, prompt, logUsage);
+            recordDecision(bundle, {
+                kind: 'create',
+                runId: bundle.runId ?? '',
+                steps: minted,
+            });
+            return this.stepAtCursor(bundle, prompt, logUsage, boardText);
         }
         // 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) {
+        if (lastOutcome === 'failed' ||
+            lastOutcome === 'partial' ||
+            resumedExternal) {
             const system = resumedExternal
                 ? EXTERNAL_RESULT_REPLAN_SYSTEM
                 : REPLAN_SYSTEM;
@@ -163,29 +228,40 @@ export class AdaptivePlanner {
             // 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);
+            const rest = await this.callPlan(system, bundle, prompt, retrying, logUsage, completed, options, boardText);
             if (rest === null)
                 return null;
-            bundle.plan = [...bundle.plan.slice(0, cursor), ...rest];
+            const anchor = bundle.plan[cursor]?.stepId ?? '';
+            const mintedRest = mintReplanStepIds(rest, bundle.runId ?? '', anchor);
+            bundle.plan = [...bundle.plan.slice(0, cursor), ...mintedRest];
+            recordDecision(bundle, {
+                kind: 'replan',
+                runId: bundle.runId ?? '',
+                anchor,
+                steps: mintedRest,
+            });
             // 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);
+            return this.stepAtCursor(bundle, prompt, logUsage, boardText);
         }
         // 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);
+        return this.stepAtCursor(bundle, prompt, logUsage, boardText);
     }
     /** 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') {
+        // 'advanced' and 'partial' both advance the cursor: the accepted part of a
+        // partial is committed and must not be re-run (the remainder is replanned at
+        // the next cursor). 'failed' leaves the cursor for next()'s replan.
+        if (outcome === 'advanced' || outcome === 'partial') {
             bundle.planCursor = (bundle.planCursor ?? 0) + 1;
         }
     }
@@ -193,7 +269,7 @@ export class AdaptivePlanner {
      *  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) {
+    async stepAtCursor(bundle, prompt, logUsage, boardText) {
         const plan = bundle.plan ?? [];
         const cursor = bundle.planCursor ?? 0;
         if (cursor >= plan.length) {
@@ -201,7 +277,7 @@ export class AdaptivePlanner {
                 { role: 'system', content: appendHint(FINALIZE_SYSTEM, this.hint) },
                 {
                     role: 'user',
-                    content: `Goal: ${bundle.goal}\nRequest: ${prompt}\nProgress:${bundle.plannerPrivate}`,
+                    content: `Goal: ${bundle.goal}\nRequest: ${prompt}\nProgress:${progressBlock(bundle, boardText)}`,
                 },
             ]);
             logUsage?.('finalizer', res.usage);
@@ -213,13 +289,19 @@ export class AdaptivePlanner {
         }
         return { kind: 'next', step: plan[cursor] };
     }
-    async callPlan(system, bundle, prompt, retrying, logUsage, completed = []) {
+    async callPlan(system, bundle, prompt, retrying, logUsage, completed = [], options, boardText) {
         // 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')}`
             : '';
+        // Recall the configured controller skill group BEFORE the LLM call and inject
+        // its bounded block. When the hook is absent OR returns '' the user message is
+        // byte-identical to the agnostic prompt (the measurement toggle).
+        const skillsBlock = this.skillsRecall
+            ? await this.skillsRecall(bundle.goal, options)
+            : '';
         const res = await this.planner.send([
             {
                 role: 'system',
@@ -230,7 +312,7 @@ export class AdaptivePlanner {
             },
             {
                 role: 'user',
-                content: `Goal: ${bundle.goal}\nProgress:${bundle.plannerPrivate}${completedBlock}\nRequest: ${prompt}`,
+                content: withSkillsBlock(`Goal: ${bundle.goal}\nProgress:${progressBlock(bundle, boardText)}${completedBlock}\nRequest: ${prompt}`, skillsBlock),
             },
         ]);
         logUsage?.('planner', res.usage);
@@ -239,9 +321,9 @@ export class AdaptivePlanner {
         return parsePlan(res.content);
     }
 }
-export function makePlanner(kind, planner, hint) {
+export function makePlanner(kind, planner, hint, skillsRecall) {
     return kind === 'adaptive'
-        ? new AdaptivePlanner(planner, hint)
-        : new IncrementalPlanner(planner, hint);
+        ? new AdaptivePlanner(planner, hint, skillsRecall)
+        : new IncrementalPlanner(planner, hint, skillsRecall);
 }
 //# sourceMappingURL=planner.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { LlmUsage } from '@mcp-abap-adt/llm-agent';
+import type { ReviewOutcome } from './outcome.js';
+import type { ISubagentClient } from './subagent-client.js';
+import type { Step } from './types.js';
+/** One reference's evidence: the closest stored artifact's content (or none). */
+export interface Evidence {
+    ref: string;
+    hit: boolean;
+    topArtifact?: string;
+}
+export interface ReviewOpts {
+    hint?: string;
+    logUsage?: (role: string, u?: LlmUsage) => void;
+    /** Defensive cap on the returned `digest` (§B). Defaults to 500 when omitted. */
+    maxDigestChars?: number;
+}
+/** The reviewer's return: EITHER an authoritative step Outcome (incl. a genuine
+ *  `failed` verdict → step replan), OR a judge-failure — the reviewer could not
+ *  produce ANY usable verdict (provider/transport error, unparsable JSON, or a
+ *  missing/invalid status). The controller re-asks a judge-failure within
+ *  `maxReviewRetries` and, on exhaustion, DEGRADES it to a failed step (→ replan),
+ *  bounded by `maxStepAttempts`/`maxSteps` — it does NOT abort the run. (A
+ *  well-formed but contradictory verdict — ok/exists/partial with empty `approved` —
+ *  is coerced to a `failed` Outcome in `parseReview`, NOT a judge-failure.) */
+export type ReviewResult = {
+    kind: 'outcome';
+    outcome: ReviewOutcome;
+} | {
+    kind: 'judge-failure';
+    reason: string;
+};
+/** Separate judging role. The controller depends ONLY on this; `status` always
+ *  comes through a well-formed Outcome. Default impl is LLM-backed; swappable. */
+export interface IReviewer {
+    review(step: Step, evidence: readonly Evidence[], executorResult: string, opts: ReviewOpts): Promise<ReviewResult>;
+}
+export declare class LlmReviewer implements IReviewer {
+    private readonly client;
+    constructor(client: ISubagentClient);
+    review(step: Step, evidence: readonly Evidence[], executorResult: string, opts: ReviewOpts): Promise<ReviewResult>;
+}
+/** Parse a reviewer reply into a ReviewResult. A well-formed verdict (any of
+ *  ok/exists/partial/failed) is an `outcome`; ok/exists/partial with EMPTY approved
+ *  is coerced to a `failed` outcome (contradictory → replan, not abort). Only a
+ *  truly unusable reply — unparsable JSON or missing/invalid status — is a
+ *  `judge-failure` (re-ask within budget, then degrade to a failed step). */
+export declare function parseReview(content: string, maxDigestChars?: number): ReviewResult;
+//# sourceMappingURL=reviewer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/reviewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IAChD,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;+EAO+E;AAC/E,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C;kFACkF;AAClF,MAAM,WAAW,SAAS;IACxB,MAAM,CACJ,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAwBD,qBAAa,WAAY,YAAW,SAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,MAAM,CACV,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC;CA8BzB;AAED;;;;6EAI6E;AAC7E,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,cAAc,SAAM,GACnB,YAAY,CAyDd"}

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

@@ -0,0 +1,116 @@
+import { extractJsonObject } from './controller-coordinator-handler.js';
+import { appendHint } from './prompts.js';
+const REVIEWER_SYSTEM = 'You are the reviewer. You did NOT do the work — you JUDGE it. Given the ' +
+    "step intent, the per-reference evidence, and the executor's result, decide " +
+    'the authoritative outcome and return a SINGLE JSON object: ' +
+    '{"status":"ok"|"exists"|"failed"|"partial","approved":<content to keep>,' +
+    '"remainder":<what is still missing>,"note":<short reason>,' +
+    '"digest":<a SHORT plain-text extract of what this step established that the ' +
+    'PLANNER needs to decide the next step — e.g. the key names/ids/outcome, NOT ' +
+    'the full content>}. ' +
+    'Use "ok" when the step is fully satisfied, "exists" when the target already ' +
+    'existed (idempotent no-op success), "partial" when only part is done (put the ' +
+    'accepted content in "approved" and what remains in "remainder"), "failed" when ' +
+    'the result does not satisfy the step. "approved" MUST be non-empty for ok/' +
+    'exists/partial. Judge ONLY from the evidence + result; do NOT invent facts. ' +
+    'The evidence lists, per required reference, the CLOSEST stored artifact (or ' +
+    'MISSING). Decide for YOURSELF whether that artifact actually satisfies the ' +
+    'reference — a closest-match artifact may be irrelevant; treat an unsatisfied or ' +
+    'missing required reference as "failed" (note: "missing input: <ref>"). ' +
+    'The "digest" is REQUIRED and MUST be a non-empty plain-text string (keep it ' +
+    'brief — the full result is stored separately). ' +
+    'Output JSON only.';
+export class LlmReviewer {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async review(step, evidence, executorResult, opts) {
+        const evidenceBlock = evidence
+            .map((e) => e.topArtifact
+            ? // topArtifact is already a relevance-oriented, bounded extract.
+                `- ${e.ref}: closest artifact →\n${e.topArtifact}`
+            : `- ${e.ref}: MISSING (no artifact found)`)
+            .join('\n');
+        const res = await this.client.send([
+            { role: 'system', content: appendHint(REVIEWER_SYSTEM, opts.hint) },
+            {
+                role: 'user',
+                content: `Step: ${step.name}\nIntent: ${step.instructions}\n` +
+                    `Evidence:\n${evidenceBlock || '(none)'}\n` +
+                    `Executor result:\n${executorResult}`,
+            },
+        ]);
+        opts.logUsage?.('reviewer', res.usage);
+        if (res.kind !== 'content') {
+            // Provider/transport error → JUDGE failure (the verdict is unknown), NOT a
+            // step failure.
+            return {
+                kind: 'judge-failure',
+                reason: `reviewer error: ${res.kind === 'error' ? res.error : res.kind}`,
+            };
+        }
+        return parseReview(res.content, opts.maxDigestChars ?? 500);
+    }
+}
+/** Parse a reviewer reply into a ReviewResult. A well-formed verdict (any of
+ *  ok/exists/partial/failed) is an `outcome`; ok/exists/partial with EMPTY approved
+ *  is coerced to a `failed` outcome (contradictory → replan, not abort). Only a
+ *  truly unusable reply — unparsable JSON or missing/invalid status — is a
+ *  `judge-failure` (re-ask within budget, then degrade to a failed step). */
+export function parseReview(content, maxDigestChars = 500) {
+    const json = extractJsonObject(content);
+    if (json === null)
+        return { kind: 'judge-failure', reason: 'unparsable reviewer reply' };
+    try {
+        const o = JSON.parse(json);
+        const status = o.status;
+        const approved = typeof o.approved === 'string' ? o.approved : '';
+        const remainder = typeof o.remainder === 'string' ? o.remainder : '';
+        const note = typeof o.note === 'string' ? o.note : '';
+        const rawDigest = typeof o.digest === 'string' ? o.digest : '';
+        if (status !== 'ok' &&
+            status !== 'exists' &&
+            status !== 'failed' &&
+            status !== 'partial') {
+            return { kind: 'judge-failure', reason: 'missing/invalid status' };
+        }
+        // Digest is REQUIRED on every settle (it is the planner's board content). A
+        // missing/empty digest is a judge-failure (re-ask), distinct from a real
+        // verdict. Bound it defensively (the full result is in RAG regardless).
+        if (rawDigest.trim().length === 0) {
+            return { kind: 'judge-failure', reason: 'missing digest' };
+        }
+        const digest = rawDigest.slice(0, maxDigestChars);
+        if ((status === 'ok' || status === 'exists' || status === 'partial') &&
+            approved.length === 0) {
+            const coercedNote = note
+                ? `${note} [coerced: reviewer returned ${status} with empty approved]`
+                : `reviewer returned ${status} with empty approved`;
+            return {
+                kind: 'outcome',
+                outcome: {
+                    status: 'failed',
+                    approved: '',
+                    remainder: remainder || approved,
+                    note: coercedNote,
+                    digest: (note || coercedNote).slice(0, maxDigestChars),
+                },
+            };
+        }
+        if (status === 'partial' && remainder.trim().length === 0) {
+            return {
+                kind: 'outcome',
+                outcome: { status: 'ok', approved, remainder: '', note, digest },
+            };
+        }
+        return {
+            kind: 'outcome',
+            outcome: { status, approved, remainder, note, digest },
+        };
+    }
+    catch {
+        return { kind: 'judge-failure', reason: 'unparsable reviewer reply' };
+    }
+}
+//# sourceMappingURL=reviewer.js.map

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

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

package/dist/smart-agent/controller/run-scope.d.ts

@@ -0,0 +1,50 @@
+import type { KnowledgeBackend } from '@mcp-abap-adt/llm-agent-libs';
+import type { SessionBundle } from './types.js';
+/** Injectable runId minter (matches the existing id-minter pattern); tests pass a
+ *  deterministic counter. Default is time+random based. */
+export type RunIdMinter = () => string;
+/** Canonical identity fingerprint of a request: a hash of the NORMALIZED text
+ *  (trimmed, internal whitespace collapsed). Used only for identity comparison —
+ *  the verbatim request is kept separately for the finalizer. */
+export declare function fingerprintRequest(request: string): string;
+export type TerminalOutcome = {
+    kind: 'success';
+    answer: string;
+} | {
+    kind: 'error';
+    error: string;
+};
+/** Persist a terminal outcome keyed by runId with a TTL. Written into the same
+ *  KnowledgeBackend as the bundle but under a distinct artifactType so it
+ *  survives the next run's bundle reset (the TTL promise). `nowIso` is passed so
+ *  the caller controls time. */
+export declare function writeTerminal(be: KnowledgeBackend, sessionId: string, runId: string, terminalOutcome: TerminalOutcome, ttlMs: number, nowIso: string): Promise<void>;
+/** Read the latest non-expired terminal outcome for runId, or undefined. */
+export declare function readTerminal(be: KnowledgeBackend, sessionId: string, runId: string, nowIso: string): Promise<TerminalOutcome | undefined>;
+/** The runIds whose terminal entries are expired as of nowIso (backends without
+ *  delete simply ignore stale rows on read). */
+export declare function gcTerminal(be: KnowledgeBackend, sessionId: string, nowIso: string): Promise<string[]>;
+export type Classification = {
+    kind: 'fresh';
+} | {
+    kind: 'resume';
+} | {
+    kind: 'replay';
+    runId: string;
+} | {
+    kind: 'not-found';
+};
+export interface ClassifyInput {
+    bundle: SessionBundle;
+    incomingRequest: string;
+    /** Explicit idempotency key / runId supplied by the caller (if any). */
+    explicitKey?: string;
+    /** True when the consumer set the newRun flag for THIS request. */
+    newRun?: boolean;
+    /** Whether `explicitKey` (or, for fingerprint matches, the current bundle's
+     *  runId) has a non-expired terminal-store entry. */
+    terminalExists: boolean;
+}
+/** Strict ordered request classification. First matching branch wins. */
+export declare function classifyRequest(input: ClassifyInput): Classification;
+//# sourceMappingURL=run-scope.d.ts.map

package/dist/smart-agent/controller/run-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-scope.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/run-scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;2DAC2D;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC;AAEvC;;iEAEiE;AACjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D;AAQD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AASrC;;;gCAGgC;AAChC,wBAAsB,aAAa,CACjC,EAAE,EAAE,gBAAgB,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAef;AAED,4EAA4E;AAC5E,wBAAsB,YAAY,CAChC,EAAE,EAAE,gBAAgB,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAgBtC;AAED;gDACgD;AAChD,wBAAsB,UAAU,CAC9B,EAAE,EAAE,gBAAgB,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAMD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;yDACqD;IACrD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAwBpE"}