@mcp-abap-adt/llm-agent 18.0.1 → 18.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/interfaces/coordinator.d.ts +15 -1
- package/dist/interfaces/coordinator.d.ts.map +1 -1
- package/dist/interfaces/evaluator.d.ts +46 -0
- package/dist/interfaces/evaluator.d.ts.map +1 -0
- package/dist/interfaces/evaluator.js +2 -0
- package/dist/interfaces/evaluator.js.map +1 -0
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { ILlm } from './llm.js';
|
|
2
2
|
import type { ISkillMeta } from './skill.js';
|
|
3
3
|
import type { ISubAgent, ISubAgentResult, SubAgentRegistry } from './subagent.js';
|
|
4
|
-
import type { LlmUsage } from './types.js';
|
|
4
|
+
import type { LlmTool, LlmUsage } from './types.js';
|
|
5
5
|
export interface PlanStep {
|
|
6
6
|
id: string;
|
|
7
7
|
goal: string;
|
|
@@ -78,6 +78,20 @@ export interface ICoordinatorContext {
|
|
|
78
78
|
stepResults: Record<string, StepResult>;
|
|
79
79
|
signal?: AbortSignal;
|
|
80
80
|
sessionId: string;
|
|
81
|
+
/**
|
|
82
|
+
* Per-request RAG-selected tools (MCP + client external) available to a
|
|
83
|
+
* self-dispatched step's tool-loop (#157). Empty/absent → the step runs a
|
|
84
|
+
* single toolless `llm.chat()` (legacy behaviour).
|
|
85
|
+
*/
|
|
86
|
+
selectedTools?: readonly LlmTool[];
|
|
87
|
+
/**
|
|
88
|
+
* Executes a tool by name and returns its textual result. Built by the
|
|
89
|
+
* coordinator handler from the connected MCP clients. With `selectedTools`,
|
|
90
|
+
* this lets a self-dispatched step actually CALL MCP (read a table, list a
|
|
91
|
+
* package, …) instead of hallucinating a toolless answer (#157). Absent →
|
|
92
|
+
* no tool-loop.
|
|
93
|
+
*/
|
|
94
|
+
callTool?: (name: string, args: unknown, signal?: AbortSignal) => Promise<string>;
|
|
81
95
|
}
|
|
82
96
|
export interface IPlanningStrategy {
|
|
83
97
|
readonly name: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/interfaces/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/interfaces/coordinator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { IKnowledgeRagHandle, IToolsRagHandle } from './knowledge-rag.js';
|
|
2
|
+
import type { RunIdentity } from './stepper.js';
|
|
3
|
+
import type { ITaskSpec } from './task-spec.js';
|
|
4
|
+
/**
|
|
5
|
+
* The Evaluator's verdict on a (sub-)prompt — the 18.1 control spine. Distinct
|
|
6
|
+
* from the planner (decomposes the task) and the reviewer (reviews OUTPUT): the
|
|
7
|
+
* Evaluator judges the INPUT — whether the (sub-)prompt is complete/executable —
|
|
8
|
+
* WITH the RAG context, and the coordinator routes on the result.
|
|
9
|
+
*/
|
|
10
|
+
export type EvaluatorRoute = 'executable' | 'needs-work' | 'needs-consumer';
|
|
11
|
+
export interface EvaluatorVerdict {
|
|
12
|
+
route: EvaluatorRoute;
|
|
13
|
+
/**
|
|
14
|
+
* For `needs-work`: the named gaps (what to gather/do first), fed to the
|
|
15
|
+
* planner as hints. For `needs-consumer`: the question(s) to ask the consumer.
|
|
16
|
+
* Empty for `executable`.
|
|
17
|
+
*/
|
|
18
|
+
missing: string[];
|
|
19
|
+
/** One-line rationale (logged; surfaced to the consumer only on needs-consumer). */
|
|
20
|
+
reason?: string;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Per-level task assessor. Runs in `Stepper.run` before planning and returns a
|
|
24
|
+
* verdict that drives the coordinator:
|
|
25
|
+
* - `executable` → terminal executor leaf (the recursion termination condition);
|
|
26
|
+
* - `needs-work` → plan gather/sub-steps and proceed (verdict.missing = gaps);
|
|
27
|
+
* - `needs-consumer`→ return to the consumer with clarifying questions.
|
|
28
|
+
*
|
|
29
|
+
* It MUST consult the RAG context: `knowledgeRag` (what is already known/gathered)
|
|
30
|
+
* and `toolsRag` (what CAN be obtained) — the needs-work vs needs-consumer split
|
|
31
|
+
* hinges on whether a listed tool could obtain the missing fact. "What
|
|
32
|
+
* completeness means" is agnostic: it comes from the consumer's RAG skills.
|
|
33
|
+
*/
|
|
34
|
+
export interface IEvaluator {
|
|
35
|
+
readonly name: string;
|
|
36
|
+
readonly model?: string;
|
|
37
|
+
evaluate(input: {
|
|
38
|
+
prompt: string;
|
|
39
|
+
knowledgeRag: IKnowledgeRagHandle;
|
|
40
|
+
toolsRag: IToolsRagHandle;
|
|
41
|
+
taskSpec?: ITaskSpec;
|
|
42
|
+
identity: RunIdentity;
|
|
43
|
+
signal?: AbortSignal;
|
|
44
|
+
}): Promise<EvaluatorVerdict>;
|
|
45
|
+
}
|
|
46
|
+
//# sourceMappingURL=evaluator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/interfaces/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,CAAC;IACtB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,mBAAmB,CAAC;QAClC,QAAQ,EAAE,eAAe,CAAC;QAC1B,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB,QAAQ,EAAE,WAAW,CAAC;QACtB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/B"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/interfaces/evaluator.ts"],"names":[],"mappings":""}
|
package/package.json
CHANGED