@mcp-abap-adt/llm-agent-rag 12.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/README.md +57 -0
- package/package.json +64 -0
package/README.md
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# @mcp-abap-adt/llm-agent-rag
|
|
2
|
+
|
|
3
|
+
RAG and embedder composition for the SmartAgent runtime.
|
|
4
|
+
|
|
5
|
+
## Exports
|
|
6
|
+
|
|
7
|
+
- `makeRag(cfg, options): Promise<IRag>` — async, dynamic-imports the configured backend (e.g. `OllamaRag`).
|
|
8
|
+
- `resolveEmbedder(cfg, options): IEmbedder` — synchronous, requires prior `prefetchEmbedderFactories(...)`.
|
|
9
|
+
- `prefetchEmbedderFactories(names): Promise<void>`, `prefetchRagFactories(names): Promise<void>` — warm-up helpers.
|
|
10
|
+
- `resolvePrefetchedEmbedder(name, opts)`, `resolveRag(name, opts)` — synchronous resolvers from the prefetched cache.
|
|
11
|
+
- `builtInEmbedderFactories` — registry record of built-in embedder factories.
|
|
12
|
+
- Types: `RagResolutionConfig`, `RagResolutionOptions`, `EmbedderResolutionConfig`, `EmbedderResolutionOptions`, `EmbedderFactoryOpts`.
|
|
13
|
+
|
|
14
|
+
## Two patterns
|
|
15
|
+
|
|
16
|
+
### Common case (one-shot async resolution)
|
|
17
|
+
|
|
18
|
+
```ts
|
|
19
|
+
import { makeRag } from '@mcp-abap-adt/llm-agent-rag';
|
|
20
|
+
const rag = await makeRag(
|
|
21
|
+
{ type: 'ollama', model: 'llama3', /* ... */ },
|
|
22
|
+
{ embedder: yourEmbedder, breaker: yourBreaker },
|
|
23
|
+
);
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Hot-path consumers (prefetch once, sync resolve)
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
import {
|
|
30
|
+
prefetchEmbedderFactories,
|
|
31
|
+
prefetchRagFactories,
|
|
32
|
+
resolveRag,
|
|
33
|
+
} from '@mcp-abap-adt/llm-agent-rag';
|
|
34
|
+
|
|
35
|
+
await prefetchEmbedderFactories(['openai']);
|
|
36
|
+
await prefetchRagFactories(['qdrant']);
|
|
37
|
+
|
|
38
|
+
// Inside a hot loop:
|
|
39
|
+
const rag = resolveRag('qdrant', { embedder, breaker, /* ... */ });
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Optional peer dependencies
|
|
43
|
+
|
|
44
|
+
Install only the backends you use:
|
|
45
|
+
|
|
46
|
+
| Backend | Package |
|
|
47
|
+
|---|---|
|
|
48
|
+
| OpenAI embeddings | `@mcp-abap-adt/openai-embedder` |
|
|
49
|
+
| Ollama embeddings | `@mcp-abap-adt/ollama-embedder` |
|
|
50
|
+
| SAP AI Core embeddings | `@mcp-abap-adt/sap-aicore-embedder` |
|
|
51
|
+
| Qdrant vector store | `@mcp-abap-adt/qdrant-rag` |
|
|
52
|
+
| HANA vector store | `@mcp-abap-adt/hana-vector-rag` |
|
|
53
|
+
| Postgres+pgvector | `@mcp-abap-adt/pg-vector-rag` |
|
|
54
|
+
|
|
55
|
+
Missing backends throw `MissingProviderError` (from `@mcp-abap-adt/llm-agent`) at first use.
|
|
56
|
+
|
|
57
|
+
See `docs/ARCHITECTURE.md` for the full SmartAgent package layout.
|
package/package.json
ADDED
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@mcp-abap-adt/llm-agent-rag",
|
|
3
|
+
"version": "12.0.2",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"types": "dist/index.d.ts",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": {
|
|
9
|
+
"types": "./dist/index.d.ts",
|
|
10
|
+
"import": "./dist/index.js"
|
|
11
|
+
}
|
|
12
|
+
},
|
|
13
|
+
"files": [
|
|
14
|
+
"dist",
|
|
15
|
+
"README.md"
|
|
16
|
+
],
|
|
17
|
+
"scripts": {
|
|
18
|
+
"build": "tsc -p tsconfig.json",
|
|
19
|
+
"clean": "tsc -p tsconfig.json --clean",
|
|
20
|
+
"test": "node --import tsx/esm --test --test-reporter=spec 'src/**/*.test.ts'"
|
|
21
|
+
},
|
|
22
|
+
"dependencies": {
|
|
23
|
+
"@mcp-abap-adt/llm-agent": "*"
|
|
24
|
+
},
|
|
25
|
+
"peerDependencies": {
|
|
26
|
+
"@mcp-abap-adt/openai-embedder": "^12.0.0",
|
|
27
|
+
"@mcp-abap-adt/ollama-embedder": "^12.0.0",
|
|
28
|
+
"@mcp-abap-adt/sap-aicore-embedder": "^12.0.0",
|
|
29
|
+
"@mcp-abap-adt/qdrant-rag": "^12.0.0",
|
|
30
|
+
"@mcp-abap-adt/hana-vector-rag": "^12.0.0",
|
|
31
|
+
"@mcp-abap-adt/pg-vector-rag": "^12.0.0"
|
|
32
|
+
},
|
|
33
|
+
"peerDependenciesMeta": {
|
|
34
|
+
"@mcp-abap-adt/openai-embedder": {
|
|
35
|
+
"optional": true
|
|
36
|
+
},
|
|
37
|
+
"@mcp-abap-adt/ollama-embedder": {
|
|
38
|
+
"optional": true
|
|
39
|
+
},
|
|
40
|
+
"@mcp-abap-adt/sap-aicore-embedder": {
|
|
41
|
+
"optional": true
|
|
42
|
+
},
|
|
43
|
+
"@mcp-abap-adt/qdrant-rag": {
|
|
44
|
+
"optional": true
|
|
45
|
+
},
|
|
46
|
+
"@mcp-abap-adt/hana-vector-rag": {
|
|
47
|
+
"optional": true
|
|
48
|
+
},
|
|
49
|
+
"@mcp-abap-adt/pg-vector-rag": {
|
|
50
|
+
"optional": true
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
"devDependencies": {
|
|
54
|
+
"@mcp-abap-adt/openai-embedder": "*",
|
|
55
|
+
"@mcp-abap-adt/ollama-embedder": "*",
|
|
56
|
+
"@mcp-abap-adt/sap-aicore-embedder": "*",
|
|
57
|
+
"@mcp-abap-adt/qdrant-rag": "*",
|
|
58
|
+
"@mcp-abap-adt/hana-vector-rag": "*",
|
|
59
|
+
"@mcp-abap-adt/pg-vector-rag": "*"
|
|
60
|
+
},
|
|
61
|
+
"publishConfig": {
|
|
62
|
+
"access": "public"
|
|
63
|
+
}
|
|
64
|
+
}
|