{"ref":"artifact:mi8y-cap-agents-aicore-vectorstore","page":"/artifacts/mi8y-cap-agents-aicore-vectorstore","json":"/artifacts/mi8y-cap-agents-aicore-vectorstore.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"mi8y-cap-agents-aicore-vectorstore","name":"@mi8y/cap-agents-aicore-vectorstore","artifact_type":"package","ecosystem":"cap","domain":"ai-and-agents","origin_ring":"independent","description":{"one_line":"A LangChain vector store backed by SAP AI Core Document Grounding: the collection holds the documents and makes the embeddings, and the CAP application stores no vectors of its own.","short":"LangChain vector store on SAP AI Core Document Grounding","what_it_solves":"[@mi8y/cap-agents-cds-vectorstore](artifact:mi8y-cap-agents-cds-vectorstore) keeps documents in the CAP database; `AICoreVectorStore` points at a Document Grounding collection in [SAP AI Core](artifact:btp-ai-core) instead, so there is no CDS persistence model to deploy and no embeddings implementation to supply. Each `addDocuments()` call creates one Grounding document with a UUID v7 and makes every LangChain document a chunk under it, and a retrieved chunk comes back as one LangChain document with document and chunk metadata merged and the collection, document and chunk identifiers under `metadata.grounding`. Filtering takes SAP AI Core's own retrieval fields, `documentMetadata`, `chunkMetadata`, `dataRepositoryMetadata`, `filter` and `scoringConfiguration`, rather than the Mongo-style operators the CDS store accepts, and the adapter pins the collection ID, the `vector` repository type and the chunk count whatever the filter says. It stops at the collection's contents: `delete()` needs one parent Grounding document ID and removes every chunk under it, a single chunk cannot be deleted through the adapter, collection lifecycle stays outside it, and `similaritySearchVectorWithScore()` is unsupported because Grounding takes a text query rather than a caller's vector."},"links":{"npm":"https://www.npmjs.com/package/@mi8y/cap-agents-aicore-vectorstore","repo":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cap-agents-aicore-vectorstore"},"identity":{"license":"MIT"},"compat":{"runtimes":["node"],"cds_range":">=10","typed":true},"provides":[{"capability":"capability:retrieval-augmented-generation","what_it_does":"Reaches a Document Grounding collection through the LangChain vector store interface, so ingestion, chunk storage, embedding and retrieval happen in SAP AI Core and nothing is persisted in the application's database.","sources":[{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cap-agents-aicore-vectorstore","title":"@mi8y/cap-agents-aicore-vectorstore — README","checked":"2026-09-21","quote":"A LangChain `VectorStore` for SAP CAP applications backed by the SAP AI Core Document Grounding service."},{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cap-agents-aicore-vectorstore","title":"@mi8y/cap-agents-aicore-vectorstore — README","checked":"2026-09-21","quote":"SAP AI Core owns document storage, embedding, and retrieval. The package therefore needs no CDS persistence model or client-side LangChain embeddings implementation."}]}],"requires":[{"ref":"artifact:btp-ai-core","for":"The Document Grounding collection it reads and writes: the package needs an existing collection and credentials for the service, through a binding or a configured destination.","requirement":"required","sources":[{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cap-agents-aicore-vectorstore","title":"@mi8y/cap-agents-aicore-vectorstore — README, Installation","checked":"2026-09-21","quote":"An existing SAP AI Core Document Grounding collection"},{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cap-agents-aicore-vectorstore","title":"@mi8y/cap-agents-aicore-vectorstore — README, Installation","checked":"2026-09-21","quote":"SAP AI Core credentials through a service binding or a configured SAP Cloud SDK destination"}]}],"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-09-21"},"maintainers":["actor:anselm94","actor:mi8y"],"contributors":["actor:anselm94"],"drafted_with_ai":true},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"good","evidence":"1 month since release"},{"label":"Continuity","tier":"good","evidence":"3 contributors, 2 publishers, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-10, not archived"}],"compatibility":[{"label":"Declared for","tier":"good","evidence":">=10 — includes cds 10"},{"label":"Survived majors","tier":"unknown","evidence":"first released after @sap/cds 10 shipped"},{"label":"Maintainer's CI","tier":"good","evidence":"release green, 2026-10-21"}],"practice":[{"label":"Tests","tier":"good","evidence":"24 test files, npm test"},{"label":"Docs","tier":"good","evidence":"docs/ with 1 page, README 7 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":8,"unit":"installs/week"},{"value":2,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","latest_version":"0.2.0","majors":{"0.2":{"version":"0.2.0","date":"2026-09-17"}},"license":"MIT","first_release":"2026-09-17","last_release":"2026-09-17","releases":1,"cadence_days":null,"maintainers":2,"repository":"git+https://github.com/mi8y/cap-agents-plugins.git","repository_directory":null,"peer_cds":">=10","test_script":true,"types":true,"downloads_weekly":8,"stars":2,"forks":0,"open_issues":2,"archived":false,"pushed_at":"2026-10-21","license_spdx":"MIT","org_owned":true,"default_branch":"main","contributors":3,"tree_truncated":false,"test_files":24,"workflows":3,"other_ci":false,"readme_bytes":7486,"docs_files":1,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2026-09-17","last_commit":"2026-10-09","commits":4,"ci_status":"success","ci_run_at":"2026-10-21","ci_workflow":"release","ci_event":"push","readme_path":"packages/cap-agents-aicore-vectorstore/README.md","readme_sha":"0392299d27e20ff3384732963c66673587886a8c","months_since_release":1,"dormant":false,"dependencies":1,"node_engine":null,"downloads_monthly":40,"created_at":"2026-07-08T05:15:34Z","open_prs":1,"repo_read":"2026-10-26"},"release_notes":{"license":"MIT","quotable":true,"source":{"kind":"repo","path":"packages/cap-agents-aicore-vectorstore/CHANGELOG.md","ref":"main","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cap-agents-aicore-vectorstore/CHANGELOG.md"},"format":"changesets","releases":[{"version":"0.2.0","date":"2026-09-17","date_source":"registry","heading":"0.2.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cap-agents-aicore-vectorstore/CHANGELOG.md#020","sections":[{"kind":"feature","heading":"Minor Changes","items":1}],"hash":"769f6f939cc19147"}],"versions":[{"version":"0.2.0","date":"2026-09-17"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:anselm94","name":"Merbin J Anselm","json":"/actors/anselm94.json"},{"ref":"actor:mi8y","name":"Mi8Y Technologies","json":"/actors/mi8y.json"}],"contributors":[{"ref":"actor:anselm94","name":"Merbin J Anselm","json":"/actors/anselm94.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}