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

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"}

package/dist/smart-agent/controller/run-scope.js

@@ -0,0 +1,99 @@
+import { createHash } from 'node:crypto';
+/** 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 function fingerprintRequest(request) {
+    const normalized = request.trim().replace(/\s+/g, ' ');
+    return createHash('sha256').update(normalized).digest('hex');
+}
+// ---------------------------------------------------------------------------
+// Terminal store (separate keyed TTL store)
+// ---------------------------------------------------------------------------
+const TERMINAL_ARTIFACT_TYPE = 'controller-terminal';
+/** 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 async function writeTerminal(be, sessionId, runId, terminalOutcome, ttlMs, nowIso) {
+    const expiresAt = new Date(new Date(nowIso).getTime() + ttlMs).toISOString();
+    const entry = { runId, terminalOutcome, expiresAt };
+    await be.put(sessionId, {
+        content: JSON.stringify(entry),
+        metadata: {
+            traceId: sessionId,
+            turnId: sessionId,
+            stepperId: 'controller',
+            task: 'terminal',
+            artifactType: TERMINAL_ARTIFACT_TYPE,
+            runId,
+            createdAt: nowIso,
+        },
+    });
+}
+/** Read the latest non-expired terminal outcome for runId, or undefined. */
+export async function readTerminal(be, sessionId, runId, nowIso) {
+    const now = new Date(nowIso).getTime();
+    const entries = await be.scan(sessionId);
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const e = entries[i];
+        if (e.metadata.artifactType !== TERMINAL_ARTIFACT_TYPE)
+            continue;
+        if (e.metadata.runId !== runId)
+            continue;
+        try {
+            const parsed = JSON.parse(e.content);
+            if (new Date(parsed.expiresAt).getTime() <= now)
+                return undefined;
+            return parsed.terminalOutcome;
+        }
+        catch {
+            // malformed — keep scanning backwards
+        }
+    }
+    return undefined;
+}
+/** The runIds whose terminal entries are expired as of nowIso (backends without
+ *  delete simply ignore stale rows on read). */
+export async function gcTerminal(be, sessionId, nowIso) {
+    const now = new Date(nowIso).getTime();
+    const expired = [];
+    for (const e of await be.scan(sessionId)) {
+        if (e.metadata.artifactType !== TERMINAL_ARTIFACT_TYPE)
+            continue;
+        try {
+            const parsed = JSON.parse(e.content);
+            if (new Date(parsed.expiresAt).getTime() <= now)
+                expired.push(parsed.runId);
+        }
+        catch {
+            // ignore
+        }
+    }
+    return expired;
+}
+/** Strict ordered request classification. First matching branch wins. */
+export function classifyRequest(input) {
+    const { bundle, incomingRequest, explicitKey, newRun, terminalExists } = input;
+    // 1. newRun overrides any replay.
+    if (newRun)
+        return { kind: 'fresh' };
+    // 2. Explicit key → STRICT routing, no fingerprint fallback.
+    if (explicitKey) {
+        if (terminalExists)
+            return { kind: 'replay', runId: explicitKey };
+        const live = bundle.runState === 'active' || bundle.runState === 'suspended';
+        if (explicitKey === bundle.runId && live)
+            return { kind: 'resume' };
+        return { kind: 'not-found' };
+    }
+    // 3. No key → fingerprint recovers ONLY an in-flight active run of the same
+    //    request; a terminal fingerprint match starts fresh.
+    const live = bundle.runState === 'active' || bundle.runState === 'suspended';
+    const sameRequest = bundle.originalRequest !== undefined &&
+        fingerprintRequest(bundle.originalRequest) ===
+            fingerprintRequest(incomingRequest);
+    if (live && sameRequest)
+        return { kind: 'resume' };
+    return { kind: 'fresh' };
+}
+//# sourceMappingURL=run-scope.js.map

package/dist/smart-agent/controller/run-scope.js.map

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

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

@@ -12,4 +12,9 @@ export declare function persistBundle(be: KnowledgeBackend, sessionId: string, b
  * bundle if none exists or if the stored content cannot be parsed.
  */
 export declare function hydrateBundle(be: KnowledgeBackend, sessionId: string): Promise<SessionBundle>;
+/** Atomic fresh-run reset: clears EVERY run-scoped field and starts in
+ *  `evaluating`. The caller mints + assigns a fresh `runId` and the new
+ *  `originalRequest`. The terminal store (a separate keyed TTL store) is NOT
+ *  touched here so a prior run's outcome stays replayable by its `runId`. */
+export declare function resetRun(bundle: SessionBundle, originalRequest: string): void;
 //# sourceMappingURL=session-bundle.d.ts.map

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

@@ -1 +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"}
+{"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,EAAY,aAAa,EAAE,MAAM,YAAY,CAAC;AAkB1D;;;;;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;AAED;;;6EAG6E;AAC7E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAsB7E"}

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

@@ -50,4 +50,31 @@ export async function hydrateBundle(be, sessionId) {
     }
     return emptyBundle();
 }
+/** Atomic fresh-run reset: clears EVERY run-scoped field and starts in
+ *  `evaluating`. The caller mints + assigns a fresh `runId` and the new
+ *  `originalRequest`. The terminal store (a separate keyed TTL store) is NOT
+ *  touched here so a prior run's outcome stays replayable by its `runId`. */
+export function resetRun(bundle, originalRequest) {
+    bundle.goal = '';
+    bundle.plannerPrivate = '';
+    bundle.budgets = { stepsUsed: 0, rewindsUsed: 0 };
+    bundle.plan = undefined;
+    bundle.planCursor = undefined;
+    bundle.pendingPlanDecisions = undefined;
+    bundle.pending = undefined;
+    bundle.lastOutcome = undefined;
+    bundle.runState = 'active';
+    bundle.runPhase = 'evaluating';
+    bundle.originalRequest = originalRequest;
+    bundle.nextSeq = 0;
+    bundle.inFlightStep = undefined;
+    bundle.evalCallInFlight = false;
+    bundle.plannerCallInFlight = false;
+    bundle.finalizeCallInFlight = false;
+    bundle.evalResumeCount = 0;
+    bundle.plannerResumeCount = 0;
+    bundle.finalizeAttempt = 0;
+    bundle.legacyFinalAnswer = undefined;
+    bundle.writeOrdinal = 0;
+}
 //# sourceMappingURL=session-bundle.js.map

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

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

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

@@ -1,5 +1,6 @@
-import type { LlmUsage, StreamToolCall } from '@mcp-abap-adt/llm-agent';
+import type { CallOptions, LlmUsage, Message, StreamToolCall } from '@mcp-abap-adt/llm-agent';
 import type { SmartServerLlmConfig } from '../smart-server.js';
+import type { PlanDecision } from './artifacts.js';
 export type SubagentResult = {
     kind: 'content';
     content: string;
@@ -14,10 +15,32 @@ export type SubagentResult = {
     usage?: LlmUsage;
 };
 export interface Step {
+    /** Stable plan-time identity (§F). 1:1 with a board entry; assigned at
+     *  create-plan or fan-out. Optional only so older call-sites compile during
+     *  the migration; the planner/handler always set it. */
+    stepId?: string;
     name: string;
     instructions: string;
     type?: string;
+    /** Marks a discovery step whose result enumerates remaining work (§D). */
+    discovery?: true;
+    /** When this step REPLACES a failed step on replan, the superseded `stepId` (§F). */
+    supersedesStepId?: string;
+    /** Plain-language references this step depends on (English — planner invariant).
+     *  Decided by the reviewer, not the doer; drives the per-reference evidence map. */
+    requires?: string[];
 }
+/** Contract cap on a step's dependency references. */
+export declare const MAX_REQUIRES = 8;
+/** A reference is a SHORT phrase, not a payload. */
+export declare const MAX_REQUIRE_CHARS = 200;
+/** Validate a step's optional `requires`. `undefined` for absent OR `[]` (a step
+ *  with no deps — normalize to undefined; downstream falls back to whole-step
+ *  recall); the trimmed array when valid; `false` (→ parse failure / retry) when
+ *  malformed: a non-array, > MAX_REQUIRES entries, a non-string entry, or an entry
+ *  empty / > MAX_REQUIRE_CHARS after trim (a huge reference must not reach the
+ *  semantic query / embedder). */
+export declare function validateRequires(v: unknown): string[] | undefined | false;
 export type NextStep = {
     kind: 'next';
     step: Step;
@@ -42,6 +65,33 @@ export type PendingMarker = {
      *  a plain confirmation ("yes") commits IT rather than the literal answer. */
     proposedTarget?: string;
 };
+export type RunState = 'idle' | 'active' | 'suspended' | 'terminal';
+export type RunPhase = 'evaluating' | 'planning' | 'executing' | 'finalizing';
+/** Controller-level (non-reviewer) failure that drives a replan with no reviewable
+ *  artifact (e.g. the maxToolCalls budget). Persisted atomically with
+ *  inFlightStep.phase='awaiting-replan' so a crash before the replan keeps the
+ *  reason; fed to the planner, then cleared when the revised step is set. */
+export interface ControlFailure {
+    reason: 'maxToolCalls';
+    seq: number;
+}
+export interface InFlightStep {
+    seq: number;
+    step: Step;
+    /** Fresh-execution counter (first dispatch / revised replan step). Part of the
+     *  artifact identity (runId, seq, attempt). */
+    attempt: number;
+    /** Crash-replay counter of ONE attempt; reset on commit / fresh attempt. */
+    resumeCount: number;
+    phase: 'executing' | 'awaiting-replan';
+    /** Durable executor message log for this seq — the suspend/resume + crash-replay
+     *  rebuild source; external tool results are appended here. */
+    transcript: Message[];
+    /** Durable external round-trip count; ++ persisted BEFORE each surfaced call. */
+    toolCallCount: number;
+    /** Why a controller-level replan (no reviewable artifact) — fed to the planner. */
+    controlFailure?: ControlFailure;
+}
 export interface SessionBundle {
     goal: string;
     plannerPrivate: string;
@@ -51,11 +101,38 @@ export interface SessionBundle {
     };
     plan?: Step[];
     planCursor?: number;
+    /** Plan decisions the planner produced this turn (create/replan), NOT yet
+     *  persisted. The controller drains + `writePlanDecision`s them after
+     *  `planner.next()` returns and BEFORE dispatch (§A: planner constructs, controller
+     *  persists; §F: every decision is a durable artifact). Cleared once drained, and
+     *  on `resetRun`. */
+    pendingPlanDecisions?: PlanDecision[];
     pending?: PendingMarker;
-    /** Outcome of the last executed step, persisted so a resume after a FAILED step
-     *  makes the adaptive planner replan (rather than repeat the step). Set by
-     *  runStep.settle() together with the step result + cursor advance. */
-    lastOutcome?: 'advanced' | 'failed';
+    /** Last reviewed step outcome that drives the planner transition. */
+    lastOutcome?: 'advanced' | 'failed' | 'partial';
+    runId?: string;
+    runState?: RunState;
+    runPhase?: RunPhase;
+    /** The verbatim request that started this run (finalizer input + identity
+     *  fingerprint source). */
+    originalRequest?: string;
+    nextSeq?: number;
+    inFlightStep?: InFlightStep;
+    evalCallInFlight?: boolean;
+    plannerCallInFlight?: boolean;
+    finalizeCallInFlight?: boolean;
+    evalResumeCount?: number;
+    plannerResumeCount?: number;
+    finalizeAttempt?: number;
+    /** Legacy (no-finalizer) answer: the planner's composed done.result, persisted
+     *  durably in the same write that enters `finalizing`, so a crash before the
+     *  terminal write recovers it (rather than emitting empty). Cleared by reset. */
+    legacyFinalAnswer?: string;
+    /** Monotonic per-run write ordinal; incremented BEFORE each artifact write so
+     *  recall dedup can break createdAt ties by latest-write order. Reset to 0 by
+     *  resetRun(); run-scoped ordinals are always comparable (recall filters by
+     *  runId). */
+    writeOrdinal?: number;
 }
 /** A controller subagent role: a standalone LLM config plus an OPTIONAL
  *  per-role `hint`. The hint is appended to that role's system prompt and gives
@@ -76,6 +153,9 @@ export interface ControllerConfig {
         evaluator: ControllerSubagentConfig;
         planner: ControllerSubagentConfig;
         executor: ControllerSubagentConfig;
+        /** Optional; default to the planner's config when absent (no breaking change). */
+        reviewer?: ControllerSubagentConfig;
+        finalizer?: ControllerSubagentConfig;
     };
     targetState: {
         strategy: 'consumer-confirm' | 'semantic-distance' | 'auto';
@@ -84,38 +164,67 @@ export interface ControllerConfig {
     sessionMemory: {
         collection: string;
     };
-    planner?: 'incremental' | 'adaptive';
     budgets: {
         maxSteps: number;
         maxRetries: number;
         maxRewinds: number;
         maxToolCalls?: number;
+        /** Durable fresh-attempt cap per step (bounds the non-advancing replan loop). */
+        maxStepAttempts?: number;
+        /** Durable crash-replay caps (one per LLM-invoking phase). */
+        maxStepResumes?: number;
+        maxPlannerResumes?: number;
+        maxEvalResumes?: number;
+        maxFinalizeRetries?: number;
+        /** In-process re-ask budget for judge (reviewer) provider/malformed failures. */
+        maxReviewRetries?: number;
+        /** Board render budget (§B). Defaulted in parseConfig; validated at load. */
+        maxDigestChars?: number;
+        maxIntentChars?: number;
+        maxActiveSteps?: number;
+        maxBoardChars?: number;
+        keepRecentDigests?: number;
     };
+    /** Behaviour when the finalizer's retry budget is exhausted: 'error' → terminal
+     *  control error (default); 'best-effort' → compose from approved results with an
+     *  explicit incomplete marker. */
+    onFinalizeExhausted?: 'error' | 'best-effort';
 }
-export type PlannerKind = 'incremental' | 'adaptive';
+export type PlannerKind = 'smart-executor' | 'weak-executor';
 export interface PlannerNextInput {
     bundle: SessionBundle;
     prompt: string;
     /** Outcome of the step run since the previous `next()` (undefined on the first
-     *  call / after a rewind / on resume). The adaptive planner replans on 'failed';
-     *  the incremental planner ignores it. Cursor advance on 'advanced' happens in
+     *  call / after a rewind / on resume). The plan-first planner replans on 'failed';
+     *  a planner that does not implement commit() ignores it. Cursor advance on 'advanced' happens in
      *  commit(), not here. */
-    lastOutcome?: 'advanced' | 'failed';
+    lastOutcome?: 'advanced' | 'failed' | 'partial';
     /** True when re-asking after an unparsable reply (stern format reminder). */
     retrying: boolean;
     /** True on the first call of a turn that just resumed an EXTERNAL-tool result
-     *  (the result is now in `bundle.plannerPrivate`). The adaptive planner replans
+     *  (the result is now in `bundle.plannerPrivate`). The plan-first planner replans
      *  from the cursor so it incorporates the result via the planner — which reads
      *  plannerPrivate — instead of blindly re-running the suspended step (the
-     *  executor prompt does NOT include plannerPrivate). Incremental ignores it. */
+     *  executor prompt does NOT include plannerPrivate). A no-op planner ignores it. */
     resumedExternal?: boolean;
+    /** The rendered step-state digest board (§B), reconstructed by the controller
+     *  from artifacts before each call. When present + non-empty it is the
+     *  AUTHORITATIVE step-state context, rendered ADDITIVELY ahead of the
+     *  `plannerPrivate` tail (which still carries non-board deltas — clarify answers,
+     *  the legacy external result). Empty/absent → the planner uses `plannerPrivate`
+     *  alone (board-less path; prompt byte-identical to the pre-board baseline). */
+    boardText?: string;
     logUsage?: (role: string, u?: LlmUsage) => void;
+    /** Request-scoped call options (request logger / trace / cancellation signal).
+     *  Threaded into the skills-recall hook so the recall embedding is metered,
+     *  cancellable, and joins the request trace. */
+    options?: CallOptions;
 }
 export interface IControllerPlanner {
     next(input: PlannerNextInput): Promise<NextStep | null>;
     /** Optional: record a just-finished step's outcome so the planner's durable
-     *  bookkeeping (e.g. the adaptive cursor) is updated and can be persisted in the
-     *  SAME write that follows. Incremental does not implement it (no-op). */
-    commit?(bundle: SessionBundle, outcome: 'advanced' | 'failed'): void;
+     *  bookkeeping (e.g. the plan-first cursor) is updated and can be persisted in the
+     *  SAME write that follows. A planner that does not track state need not implement it (no-op). */
+    commit?(bundle: SessionBundle, outcome: 'advanced' | 'failed' | 'partial'): void;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/controller/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,OAAO,EACP,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,IAAI;IACnB;;4DAEwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;wFACoF;IACpF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,sDAAsD;AACtD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC;;;;;kCAKkC;AAClC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,KAAK,CAazE;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB;kFAC8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9E;;;6EAG6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX;mDAC+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACvC;mEAC+D;IAC/D,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;yBAIqB;IACrB,oBAAoB,CAAC,EAAE,YAAY,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAGhD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;+BAC2B;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAI5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;qFAEiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;kBAGc;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;cAUc;AACd,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE;QACT,SAAS,EAAE,wBAAwB,CAAC;QACpC,OAAO,EAAE,wBAAwB,CAAC;QAClC,QAAQ,EAAE,wBAAwB,CAAC;QACnC,kFAAkF;QAClF,QAAQ,CAAC,EAAE,wBAAwB,CAAC;QACpC,SAAS,CAAC,EAAE,wBAAwB,CAAC;KACtC,CAAC;IACF,WAAW,EAAE;QACX,QAAQ,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,MAAM,CAAC;QAC5D,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iFAAiF;QACjF,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,8DAA8D;QAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iFAAiF;QACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,6EAA6E;QAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF;;sCAEkC;IAClC,mBAAmB,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CAC/C;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf;;;8BAG0B;IAC1B,WAAW,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChD,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;wFAIoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;oFAKgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IAChD;;oDAEgD;IAChD,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD;;sGAEkG;IAClG,MAAM,CAAC,CACL,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GACzC,IAAI,CAAC;CACT"}

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

@@ -1,2 +1,31 @@
-export {};
+/** Contract cap on a step's dependency references. */
+export const MAX_REQUIRES = 8;
+/** A reference is a SHORT phrase, not a payload. */
+export const MAX_REQUIRE_CHARS = 200;
+/** Validate a step's optional `requires`. `undefined` for absent OR `[]` (a step
+ *  with no deps — normalize to undefined; downstream falls back to whole-step
+ *  recall); the trimmed array when valid; `false` (→ parse failure / retry) when
+ *  malformed: a non-array, > MAX_REQUIRES entries, a non-string entry, or an entry
+ *  empty / > MAX_REQUIRE_CHARS after trim (a huge reference must not reach the
+ *  semantic query / embedder). */
+export function validateRequires(v) {
+    if (v === undefined)
+        return undefined;
+    if (!Array.isArray(v))
+        return false;
+    if (v.length === 0)
+        return undefined;
+    if (v.length > MAX_REQUIRES)
+        return false;
+    const out = [];
+    for (const r of v) {
+        if (typeof r !== 'string')
+            return false;
+        const t = r.trim();
+        if (t.length === 0 || t.length > MAX_REQUIRE_CHARS)
+            return false;
+        out.push(t);
+    }
+    return out;
+}
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/types.ts"],"names":[],"mappings":"AA+BA,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC;;;;;kCAKkC;AAClC,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,CAAC,CAAC,MAAM,GAAG,YAAY;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,iBAAiB;YAAE,OAAO,KAAK,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/smart-agent/embedder-knowledge-index.d.ts

@@ -0,0 +1,28 @@
+import type { CallOptions, IEmbedder, KnowledgeEntry, KnowledgeFilter } from '@mcp-abap-adt/llm-agent';
+/** Cosine similarity of two vectors (0 when either is zero-length). Exported:
+ *  reused by the controller's relevantExtract fragment-selector. */
+export declare function cosine(a: number[], b: number[]): number;
+/** Embedder-backed semantic index for the knowledge backend: filter PRE-cap, then
+ *  cosine-rank, then top-K. The runId filter is applied to the candidate set
+ *  BEFORE the cap, so a run's hits are never starved by other runs.
+ *
+ *  Infrastructure artifact types (e.g. `controller-bundle`, `controller-terminal`)
+ *  are skipped on upsert — they carry the full durable transcript and must NOT be
+ *  embedded: they waste tokens and, once the bundle grows beyond the embedder's
+ *  input limit, the JSONL rebuild fails permanently.
+ *
+ *  Recallable content (a tool/step result) is embedded from a BOUNDED PREFIX
+ *  (`maxEmbedChars`): a large MCP result (e.g. a full dictionary dump) can exceed
+ *  the embedder's input limit (SAP AI Core text-embedding-3-small: 8192 tokens),
+ *  which would 400 on upsert and break the JSONL rebuild permanently — and, since
+ *  recall runs mid-run, stall the whole controller turn. Only the embedding VECTOR
+ *  uses the prefix; the STORED entry keeps the full content, so recall still
+ *  returns the complete result. The default (16000 chars ≈ ≤ 8000 tokens even at a
+ *  pessimistic 2 chars/token) stays safely under the limit with ample ranking
+ *  signal; override per deployment if needed. */
+export declare function makeKnowledgeSemanticIndex(embedder: IEmbedder, skipArtifactTypes?: readonly string[], maxEmbedChars?: number): {
+    upsert(sid: string, e: KnowledgeEntry, options?: CallOptions): Promise<void>;
+    query(sid: string, text: string, k?: number, filter?: KnowledgeFilter, options?: CallOptions): Promise<readonly KnowledgeEntry[]>;
+    deleteSession(sid: string): void;
+};
+//# sourceMappingURL=embedder-knowledge-index.d.ts.map

package/dist/smart-agent/embedder-knowledge-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-knowledge-index.d.ts","sourceRoot":"","sources":["../../src/smart-agent/embedder-knowledge-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAQjC;oEACoE;AACpE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAUvD;AAED;;;;;;;;;;;;;;;;;iDAiBiD;AACjD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,EACnB,iBAAiB,GAAE,SAAS,MAAM,EAGjC,EACD,aAAa,SAAQ;gBASZ,MAAM,KACR,cAAc,YACP,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC;eAST,MAAM,QACL,MAAM,MACR,MAAM,WACD,eAAe,YACd,WAAW,GACpB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;uBAalB,MAAM,GAAG,IAAI;EAInC"}

package/dist/smart-agent/embedder-knowledge-index.js

@@ -0,0 +1,71 @@
+import { matchesKnowledgeFilter } from '@mcp-abap-adt/llm-agent-libs';
+/** Cosine similarity of two vectors (0 when either is zero-length). Exported:
+ *  reused by the controller's relevantExtract fragment-selector. */
+export function cosine(a, b) {
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    return na && nb ? dot / (Math.sqrt(na) * Math.sqrt(nb)) : 0;
+}
+/** Embedder-backed semantic index for the knowledge backend: filter PRE-cap, then
+ *  cosine-rank, then top-K. The runId filter is applied to the candidate set
+ *  BEFORE the cap, so a run's hits are never starved by other runs.
+ *
+ *  Infrastructure artifact types (e.g. `controller-bundle`, `controller-terminal`)
+ *  are skipped on upsert — they carry the full durable transcript and must NOT be
+ *  embedded: they waste tokens and, once the bundle grows beyond the embedder's
+ *  input limit, the JSONL rebuild fails permanently.
+ *
+ *  Recallable content (a tool/step result) is embedded from a BOUNDED PREFIX
+ *  (`maxEmbedChars`): a large MCP result (e.g. a full dictionary dump) can exceed
+ *  the embedder's input limit (SAP AI Core text-embedding-3-small: 8192 tokens),
+ *  which would 400 on upsert and break the JSONL rebuild permanently — and, since
+ *  recall runs mid-run, stall the whole controller turn. Only the embedding VECTOR
+ *  uses the prefix; the STORED entry keeps the full content, so recall still
+ *  returns the complete result. The default (16000 chars ≈ ≤ 8000 tokens even at a
+ *  pessimistic 2 chars/token) stays safely under the limit with ample ranking
+ *  signal; override per deployment if needed. */
+export function makeKnowledgeSemanticIndex(embedder, skipArtifactTypes = [
+    'controller-bundle',
+    'controller-terminal',
+], maxEmbedChars = 16000) {
+    const bySession = new Map();
+    // Bound the text handed to the embedder so an over-limit document never 400s
+    // (the full content is stored separately and returned by recall unchanged).
+    const embedInput = (text) => text.length > maxEmbedChars ? text.slice(0, maxEmbedChars) : text;
+    return {
+        async upsert(sid, e, options) {
+            // Skip infrastructure artifact types — never embed, never index.
+            if (skipArtifactTypes.includes(e.metadata.artifactType))
+                return;
+            const { vector } = await embedder.embed(embedInput(e.content), options);
+            const arr = bySession.get(sid);
+            if (arr)
+                arr.push({ entry: e, vector });
+            else
+                bySession.set(sid, [{ entry: e, vector }]);
+        },
+        async query(sid, text, k, filter, options) {
+            const all = bySession.get(sid) ?? [];
+            const scoped = filter
+                ? all.filter((x) => matchesKnowledgeFilter(x.entry.metadata, filter))
+                : all; // PRE-cap
+            const { vector: q } = await embedder.embed(embedInput(text), options);
+            const ranked = scoped
+                .map((x) => ({ e: x.entry, s: cosine(q, x.vector) }))
+                .sort((a, b) => b.s - a.s)
+                .map((x) => x.e);
+            return k ? ranked.slice(0, k) : ranked;
+        },
+        // Session reuse must NOT return a deleted session's vectors.
+        deleteSession(sid) {
+            bySession.delete(sid);
+        },
+    };
+}
+//# sourceMappingURL=embedder-knowledge-index.js.map

package/dist/smart-agent/embedder-knowledge-index.js.map

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

package/dist/smart-agent/jsonl-knowledge-backend.d.ts

@@ -1,19 +1,35 @@
-import type { KnowledgeEntry } from '@mcp-abap-adt/llm-agent';
-import type { KnowledgeBackend } from '@mcp-abap-adt/llm-agent-libs';
+import type { CallOptions, KnowledgeEntry, KnowledgeFilter } from '@mcp-abap-adt/llm-agent';
+import { type KnowledgeBackend } from '@mcp-abap-adt/llm-agent-libs';
+/** Injected semantic index (embedder-backed); see makeKnowledgeSemanticIndex. */
+interface SemanticIndex {
+    upsert(sid: string, e: KnowledgeEntry, options?: CallOptions): Promise<void>;
+    query(sid: string, text: string, k?: number, filter?: KnowledgeFilter, options?: CallOptions): Promise<readonly KnowledgeEntry[]>;
+    deleteSession(sid: string): void;
+}
 export declare class JsonlKnowledgeBackend implements KnowledgeBackend {
     private readonly logDir;
-    /** Optional semantic index for query(); when absent, query falls back to recency. */
+    /** Optional semantic index; when present query() ranks by similarity and the
+     *  index is lazily rehydrated from the durable JSONL on first use. */
     private readonly semantic?;
     constructor(logDir: string, 
-    /** Optional semantic index for query(); when absent, query falls back to recency. */
-    semantic?: {
-        upsert(sid: string, e: KnowledgeEntry): Promise<void>;
-        query(sid: string, text: string, k?: number): Promise<readonly KnowledgeEntry[]>;
-    } | undefined);
+    /** Optional semantic index; when present query() ranks by similarity and the
+     *  index is lazily rehydrated from the durable JSONL on first use. */
+    semantic?: SemanticIndex | undefined);
     private file;
-    put(sid: string, entry: KnowledgeEntry): Promise<void>;
-    semanticQuery(sid: string, text: string, k?: number): Promise<readonly KnowledgeEntry[]>;
+    private readonly built;
+    private readonly chain;
+    private run;
+    /** Lazy rehydration of the in-process index from the durable JSONL. `options`
+     *  is forwarded into every re-index `upsert` so the embedder receives the
+     *  triggering request's requestLogger — the lazy rebuild's embedding cost is
+     *  metered against the request that triggered it (not silently dropped). */
+    private build;
+    private append;
+    put(sid: string, entry: KnowledgeEntry, options?: CallOptions): Promise<void>;
+    semanticQuery(sid: string, text: string, k?: number, filter?: KnowledgeFilter, options?: CallOptions): Promise<readonly KnowledgeEntry[]>;
     scan(sid: string): Promise<readonly KnowledgeEntry[]>;
     deleteSession(sid: string): Promise<void>;
+    get semanticRecallCapable(): boolean;
 }
+export {};
 //# sourceMappingURL=jsonl-knowledge-backend.d.ts.map

package/dist/smart-agent/jsonl-knowledge-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonl-knowledge-backend.d.ts","sourceRoot":"","sources":["../../src/smart-agent/jsonl-knowledge-backend.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,qBAAa,qBAAsB,YAAW,gBAAgB;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAFT,MAAM,EAAE,MAAM;IAC/B,qFAAqF;IACpE,QAAQ,CAAC,EAAE;QAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,KAAK,CACH,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,CAAC,CAAC,EAAE,MAAM,GACT,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;KACvC,YAAA;IAGH,OAAO,CAAC,IAAI;IAIN,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,CAAC,CAAC,EAAE,MAAM,GACT,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAM/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAarD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIhD"}
+{"version":3,"file":"jsonl-knowledge-backend.d.ts","sourceRoot":"","sources":["../../src/smart-agent/jsonl-knowledge-backend.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AAEtC,iFAAiF;AACjF,UAAU,aAAa;IACrB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,KAAK,CACH,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,CAAC,CAAC,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IACtC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB;0EACsE;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAHT,MAAM,EAAE,MAAM;IAC/B;0EACsE;IACrD,QAAQ,CAAC,EAAE,aAAa,YAAA;IAG3C,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,GAAG;IAaX;;;gFAG4E;YAC9D,KAAK;YAOL,MAAM;IAMd,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC;IA0BV,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,CAAC,CAAC,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAiB/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAarD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,IAAI,qBAAqB,IAAI,OAAO,CAEnC;CACF"}