{"ref":"artifact:mi8y-cds-langgraph-persistence","page":"/artifacts/mi8y-cds-langgraph-persistence","json":"/artifacts/mi8y-cds-langgraph-persistence.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"mi8y-cds-langgraph-persistence","name":"@mi8y/cds-langgraph-persistence","artifact_type":"cds-plugin","ecosystem":"cap","domain":"ai-and-agents","origin_ring":"independent","description":{"one_line":"A LangGraph checkpointer backed by CDS, so an agent's state survives the request that created it — durability for LangChain and LangGraph agents running inside the CAP Node.js runtime.","short":"LangGraph checkpointer backed by CDS for CAP agents","what_it_solves":"LangGraph keeps a graph's state in a checkpointer; this implements that interface against the CDS persistence layer instead of a separate store. The agent's memory then lives where the application's data already lives, under the same tenant isolation and the same deployment, rather than in a second database with its own credentials and lifecycle. It now sits in the mi8y/cap-agents-addons monorepo beside three further addons, and its README points new CAP agent applications at the checkpointer [@cap-js/agents](artifact:cap-js-agents) has since added while keeping this package available for existing implementations.","to_build_on_it":"It is deliberately one thing. The author's argument is that CAP already answers identity, authentication, multitenancy, eventing, observability and CI/CD for BTP applications, so an agent framework running inside it inherits all of that and only needs the pieces the framework itself lacks — of which durable state is the first."},"links":{"npm":"https://www.npmjs.com/package/@mi8y/cds-langgraph-persistence","repo":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence"},"identity":{"author":"merbinjanselm","license":"MIT"},"compat":{"runtimes":["node"],"cds_range":">=10","typed":true},"provides":[{"capability":"capability:agent-tooling","what_it_does":"Holds one thread's state for a LangGraph agent in the CAP database: checkpoints that let a workflow resume, keep the conversation's history and support time travel, written through CDS rather than to a store of their own.","facets":[{"key":"brings","value":["State between turns"],"source":{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","title":"@mi8y/cds-langgraph-persistence — README, opening line","checked":"2026-10-15","quote":"CDS-backed LangGraph checkpoint persistence for SAP CAP applications. Checkpoints are short-term, thread-scoped state used to resume workflows, retain conversation history, and support time travel."},"applies_to":{"ecosystems":["cap"],"flavors":["node"]}},{"key":"harness","value":["LangGraph"],"source":{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","title":"@mi8y/cds-langgraph-persistence — README, opening line","checked":"2026-10-15","quote":"CDS-backed LangGraph checkpoint persistence for SAP CAP applications."},"applies_to":{"ecosystems":["cap"],"flavors":["node"]}},{"key":"state_store","value":"In the application database","source":{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","title":"@mi8y/cds-langgraph-persistence — README, opening line","checked":"2026-10-15","quote":"CDS-backed LangGraph checkpoint persistence for SAP CAP applications."},"applies_to":{"ecosystems":["cap"],"flavors":["node"]}}],"sources":[{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","title":"@mi8y/cds-langgraph-persistence — README, opening line","checked":"2026-10-15","quote":"CDS-backed LangGraph checkpoint persistence for SAP CAP applications. Checkpoints are short-term, thread-scoped state used to resume workflows, retain conversation history, and support time travel."},{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","title":"@mi8y/cds-langgraph-persistence — README, prerequisite","checked":"2026-10-15","quote":"Requires `@sap/cds >= 10`."},{"url":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","title":"@mi8y/cds-langgraph-persistence — README, what to prefer now","checked":"2026-10-15","quote":"SAP's official `@cap-js/agents` package now includes checkpointer support. Prefer it for new CAP agent applications. This package remains available for its existing CDS checkpointer implementation."}]}],"requires":[],"provenance":{"discovered_via":[{"source":"source:npm"},{"source":"source:sap-community","channel":"cap-tag"}],"first_seen":"2026-09-07"},"maintainers":["actor:anselm94","actor:mi8y"],"contributors":["actor:anselm94"],"history":[{"date":"2026-09-21","field":"links.repo","from":"https://github.com/mi8y/cds-langgraph-persistence","to":"https://github.com/mi8y/cap-agents-addons/tree/main/packages/cds-langgraph-persistence","reason":"The standalone repository was renamed: GitHub's API resolves mi8y/cds-langgraph-persistence to mi8y/cap-agents-addons, and the package now sits under packages/ beside cap-agents-memory, cap-agents-cds-vectorstore and cap-agents-aicore-vectorstore. Its own package.json points at the new repository."},{"date":"2026-09-21","field":"compat.cds_range","from":">=9","to":">=10","reason":"The package README states 'Requires `@sap/cds >= 10`' and package.json 0.7.0 declares the same peer dependency, with peerDependenciesMeta marking it not optional. The old range predates the move into the monorepo."},{"date":"2026-09-21","field":"description.what_it_solves","from":"LangGraph keeps a graph's state in a checkpointer; this implements that interface against the CDS persistence layer instead of a separate store. The agent's memory then lives where the application's data already lives, under the same tenant isolation and the same deployment, rather than in a second database with its own credentials and lifecycle.","to":"LangGraph keeps a graph's state in a checkpointer; this implements that interface against the CDS persistence layer instead of a separate store. The agent's memory then lives where the application's data already lives, under the same tenant isolation and the same deployment, rather than in a second database with its own credentials and lifecycle. It now sits in the mi8y/cap-agents-addons monorepo beside three further addons, and its README points new CAP agent applications at the checkpointer [@cap-js/agents](artifact:cap-js-agents) has since added while keeping this package available for existing implementations.","reason":"The maintainer marked the package deprecated for new applications, which the page said nowhere: the repository README reads '**Deprecated for new applications:** [`@cap-js/agents`](https://github.com/cap-js/agents) now includes checkpointer support. Prefer it for new CAP agent applications; this package remains available for existing implementations.' Reported as the maintainer's dated statement, not as a reading of ours, and the entry keeps its page, its edges and its readings."},{"date":"2026-10-15","field":"provides.agent-tooling","from":"a bare capability ref with no source","to":"what_it_does, three property values and three sources","reason":"The entry stated the capability with nothing behind it while the README says exactly what the package holds. Read on 2026-10-15: checkpoints are short-term, thread-scoped state used to resume workflows, retain conversation history and support time travel, backed by CDS, requiring @sap/cds >= 10. capability:agent-tooling declared its comparison properties the same day, so the edge now answers three of them, scoped to the node flavor. The README's sentence about what to prefer for a new application has been reworded since 2026-09-21 — it now reads 'This package remains available for its existing CDS checkpointer implementation' — and the claim the page already carries is unchanged, so only the quote on the edge is new."}],"drafted_with_ai":true},"effective_normative_relations":[{"instrument":"instrument:sap-developer-license-3-2-cap","relation":"use-constrained-by","sections":["1","2","3"],"applies_when":"A cds-plugin is used with SAP CAP materials, or an artifact is explicitly identified as a CAP plugin or application.","note":"This is inherited applicability, not a licence verdict about the artifact itself. Review the agreement for the actual materials and use; an explicit artifact relationship to another revision takes precedence.","scope":{"kind":"artifact"},"sources":[{"url":"https://cap.cloud.sap/resources/license/developer-license-3_2_CAP.txt","title":"SAP Developer License Agreement 3.2 CAP","checked":"2026-09-16","quote":"documentation, plug-ins, templates, scripts and sample code, libraries, software development kits"}],"inherited_from":"cap-plugins-and-applications","relevant_capabilities":["agent-systems-access","async-processing","data-import-export","database-connectors","deployment","destinations","llm-integration","mcp-servers","plugin-authoring","replication","retrieval-augmented-generation","rfc-connectivity"]}],"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 3 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":9,"unit":"installs/week"},{"value":2,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-25","latest_version":"0.7.0","majors":{"0.0":{"version":"0.0.1","date":"2026-07-08"},"0.2":{"version":"0.2.0","date":"2026-07-13"},"0.3":{"version":"0.3.0","date":"2026-07-13"},"0.4":{"version":"0.4.0","date":"2026-07-15"},"0.5":{"version":"0.5.0","date":"2026-07-17"},"0.6":{"version":"0.6.0","date":"2026-07-24"},"0.7":{"version":"0.7.0","date":"2026-09-17"}},"license":"MIT","first_release":"2026-07-08","last_release":"2026-09-17","releases":9,"cadence_days":2,"maintainers":2,"repository":"git+https://github.com/mi8y/cap-agents-plugins.git","peer_cds":">=10","test_script":true,"types":true,"downloads_weekly":9,"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":2773,"docs_files":1,"changelog":false,"license_file":true,"dts_files":0,"ci_status":"success","ci_run_at":"2026-10-21","ci_workflow":"release","ci_event":"push","readme_path":"packages/cds-langgraph-persistence/README.md","readme_sha":"bd04e98431e303054133fe48067ac28dfb1679c0","months_since_release":1,"dormant":false,"repository_directory":null,"first_commit":"2026-07-28","last_commit":"2026-10-21","commits":14,"dependencies":1,"node_engine":null,"downloads_monthly":64,"created_at":"2026-07-08T05:15:34Z","open_prs":1,"repo_read":"2026-10-25"},"release_notes":{"license":"MIT","quotable":true,"source":{"kind":"repo","path":"packages/cds-langgraph-persistence/CHANGELOG.md","ref":"main","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md"},"format":"changesets","releases":[{"version":"0.7.0","date":"2026-09-17","date_source":"registry","heading":"0.7.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#070","sections":[{"kind":"feature","heading":"Minor Changes","items":1},{"kind":"fix","heading":"Patch Changes","items":2}],"hash":"ec6052b7a2384002"},{"version":"0.6.0","date":"2026-07-24","date_source":"registry","heading":"0.6.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#060","sections":[{"kind":"feature","heading":"Minor Changes","items":3}],"hash":"dd58c0fd016b86aa"},{"version":"0.5.0","date":"2026-07-17","date_source":"registry","heading":"0.5.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#050","sections":[{"kind":"feature","heading":"Minor Changes","items":1}],"hash":"fecff18370915715"},{"version":"0.4.0","date":"2026-07-15","date_source":"registry","heading":"0.4.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#040","sections":[{"kind":"feature","heading":"Minor Changes","items":1}],"hash":"de66c988bbc709b8"},{"version":"0.3.0","date":"2026-07-13","date_source":"registry","heading":"0.3.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#030","sections":[{"kind":"feature","heading":"Minor Changes","items":1}],"hash":"4f85f9119e703fac"},{"version":"0.2.0","date":"2026-07-13","date_source":"registry","heading":"0.2.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#020","sections":[{"kind":"feature","heading":"Minor Changes","items":1}],"hash":"8f62d3f3e554c6cd"},{"version":"0.1.0","heading":"0.1.0","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#010","sections":[{"kind":"feature","heading":"Minor Changes","items":1}],"hash":"451e852cf3f567ed"},{"version":"0.0.3","date":"2026-07-09","date_source":"registry","heading":"0.0.3","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#003","sections":[{"kind":"fix","heading":"Patch Changes","items":1}],"hash":"e332f86c1901f830"},{"version":"0.0.2","date":"2026-07-08","date_source":"registry","heading":"0.0.2","url":"https://github.com/mi8y/cap-agents-addons/blob/main/packages/cds-langgraph-persistence/CHANGELOG.md#002","sections":[{"kind":"fix","heading":"Patch Changes","items":1}],"hash":"25383fd20c745860"}],"versions":[{"version":"0.7.0","date":"2026-09-17"},{"version":"0.6.0","date":"2026-07-24"},{"version":"0.5.0","date":"2026-07-17"},{"version":"0.4.0","date":"2026-07-15"},{"version":"0.3.0","date":"2026-07-13"},{"version":"0.2.0","date":"2026-07-13"},{"version":"0.0.3","date":"2026-07-09"},{"version":"0.0.2","date":"2026-07-08"},{"version":"0.0.1","date":"2026-07-08"}],"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":[{"ref":"content:building-durable-ai-agents-cds-langgraph-persistence","name":"Building Durable AI Agents - Announcing the cds-langgraph-persistence Plugin","json":"/content/building-durable-ai-agents-cds-langgraph-persistence.json"}],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}