@sap-ai-sdk/core
The shared internals that the packages of SAP's AI SDK build on, which its own readme says are not meant to be depended on directly.
Facts
Where it sits
Who is behind it
In the atlas: maintains 137, wrote 14@SAPmaintainerAnjanContributes to this
In the atlas: contributes to 7@anjan-poonachaSAP Cloud SDK BotContributes to this
In the atlas: contributes to 11@bot-sdk-jsBrigittaK307Contributes to this
In the atlas: contributes to 12@BrigittaK307Charles DuboisContributes to this
In the atlas: contributes to 5@CharlesDuboisSAPChristoph MatthiesContributes to this
In the atlas: contributes to 5@ChristophMatthiesDavid KnaackContributes to this
In the atlas: contributes to 13, wrote 1@davidkna-sapDeeksha SinhaContributes to this
In the atlas: contributes to 12@deekshas8Guilherme DellagustinContributes to this
In the atlas: contributes to 27@dellagustin-sapemincihangeriContributes to this
In the atlas: contributes to 12@emincihangeriTian TengContributes to this
In the atlas: contributes to 5@Herrtian21 contributors
Before choosing this
Conditions
LicenceSAP Developer License Agreement 3.2 CAP§ 3from LLM integrationCovered SAP materials or a covered CAP customer application are used as training data or to develop or refine an AI model or system.
- § 3 Artificial Intelligence Training. The agreement prohibits use of the covered materials and customer applications for training artificial-intelligence models or systems.
Calling a model for inference is not automatically AI training. Section 3 matters when the covered material or application participates in training, model development, refinement or the text-and-data-mining uses it names.
SAP Developer License Agreement 3.2 CAP →What it declares
Every artifact
- Type
- Package
- Origin
- By SAP
As a package
- Where it runs
- does not say
- Distributed through
- npm
Connections
Calling a language model with tenant and credential handling solved
Download
Install
npm add @sap-ai-sdk/coreDerived from the package name. No recipe recorded; the README has the configuration.
README
quoted from SAP/ai-sdk-js under Apache-2.0, read@sap-ai-sdk/core
This package is designed for internal usage and should not be consumed directly.
SAP Cloud SDK for AI is the official Software Development Kit (SDK) for SAP AI Core, SAP Generative AI Hub, and Orchestration Service.
This package contains core utility functions that we reuse in the SDK to set the context and execute HTTP requests.
Installation
npm install @sap-ai-sdk/core
Documentation
Visit the SAP Cloud SDK for AI (JavaScript) documentation portal to learn more about its capabilities and detailed usage.
Support, Feedback, Contribution
This project is open to feature requests, bug reports and questions via GitHub issues.
Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.
License
The SAP Cloud SDK for AI is released under the Apache License Version 2.0.
History
Features 3
Notes
Minor Changes
-
[feat] Add
gemini-3.8-flashto the model types. -
[feat] Add
gpt-6-astra,gpt-6-luna,gpt-6.1-sol,gemini-3.6-flash, andnvidia--llama-nemotron-embed-1bto the model types. -
[Improvement] Remove deprecated models
cohere--command-a-reasoning(retirement date: 2026-10-30),mistralai--mistral-medium-instruct(retirement date: 2026-11-30) — usemistralai--mistral-mediuminstead,gemini-2.5-flash-lite(retirement date: 2026-10-20) — usegemini-3.5-flash-liteinstead,sap-rpt-1.5(retirement date: 2026-12-31) — usesap-rpt-1.6instead,sap-rpt-1.5-large(retirement date: 2026-12-31) — usesap-rpt-1.6-largeinstead,sap-rpt-1-small(retirement date: 2026-12-31) — usesap-rpt-1.6instead andsap-rpt-1-large(retirement date: 2026-12-31) — usesap-rpt-1.6-largeinstead.
Features 3, Fixes 1
Notes
Minor Changes
- 0da56e2: [feat] Add
LlmBatchModeltype for models supported in LLM batch processing.BatchCreateRequest.spec.modelnow uses this type for IDE autocomplete. - 94b36e5: [Improvement] Added
mistralai--mistral-medium,sap-rpt-1.5,sap-rpt-1.5-large,sap-rpt-1.6,sap-rpt-1.6-large,gpt-5.6-sol,gpt-5.6-terra,gpt-5.6-lunato the available model list. Remove deprecated modelsgpt-4.1-nano(retirement date: 2026-10-14),gemini-2.5-flash(retirement date: 2026-10-16) andgemini-2.5-pro(retirement date: 2026-10-16). - 4b2c014: [feat] Add
gemini-3.5-flash-liteto the available model list. Remove deprecated modelmistralai--mistral-large-instruct(retirement date: 2026-09-30).
Patch Changes
- 3483acb: [fix] Set the default http agent socket timeout for AI Core requests to 1201 seconds (1201000 ms).
This overrides the Cloud SDK default of 5 seconds, which is too short for chat and streaming completions.
The value covers the orchestration server-side maximum of 1200 seconds plus 1 second of leeway.
Keep-alive is now disabled on these requests.
This avoids reusing stale sockets that a load balancer may have closed during the longer timeout.
Both settings apply only to the service-binding destination.
You can still override them with a custom destination's
agentOptionsorCustomRequestConfig.httpsAgent.
- 0da56e2: [feat] Add
Features 1
Notes
Minor Changes
- a5407c8: [feat] Add experimental OpenAI Realtime API (speech-to-speech) support for
gpt-realtimevia the@sap-ai-sdk/openai/realtimesub-path export.
- a5407c8: [feat] Add experimental OpenAI Realtime API (speech-to-speech) support for
Features 2
Notes
Minor Changes
- cca7edd: [Improvement] Add
anthropic--claude-4.5-opus,anthropic--claude-4.8-opus,gemini-3.5-flash,gemini-embeddingto the available model list. - cca7edd: [feat] Add
GcpVertexAiEmbeddingModeltype withgemini-embeddingto@sap-ai-sdk/core. AddGcpVertexAiEmbeddingModelto theEmbeddingModelunion in@sap-ai-sdk/orchestration.
- cca7edd: [Improvement] Add
Features 4
Notes
Minor Changes
- 11baf52: [Improvement] Remove deprecated models
mistralai--mistral-small-instruct(retirement date: not earlier than 2026-09-30) — usemistralai--mistral-smallinstead,amazon--nova-premier(retirement date: 2026-09-10) — useamazon--nova-lite(version: 2) instead,anthropic--claude-3-haiku(retirement date: 2026-09-10) — useanthropic--claude-4.5-haikuinstead andanthropic--claude-4-sonnet(retirement date: 2026-10-14) — useanthropic--claude-4.5-sonnetinstead. - cb8ffe7: [Improvement] Added
gpt-5.1to the available model list. - a8c9b29: [Improvement] Remove deprecated models
gpt-4.1(retirement date: 2026-10-14),gpt-4.1-mini(retirement date: 2026-10-14),o3(retirement date: 2026-10-16) ando4-mini(retirement date: 2026-10-16). - 6542a2a: [feat] Add
toReadableStream()method toSseStream. The new method converts the asynchronous iterable stream to a pull-basedReadableStreamof newline-delimited JSON, enabling composable transformations via the Web Streams APIpipeThrough()pattern with native flow control.
- 11baf52: [Improvement] Remove deprecated models
Features 2, Fixes 1
Notes
Minor Changes
- 0f10482: [feat] Add
AzureOpenAiResponsesModeltype for Azure OpenAI models that exclusively support the Responses API. - e944aa1: [Improvement] Added
gpt-5.5to the available model list. Remove retired modelanthropic--claude-4-opus— useanthropic--claude-4.7-opusinstead. Remove deprecated modelo3-mini(retirement date: 2026-08-02).
Patch Changes
- 2faf4a8: [fix] Improve error message when server sends a non-JSON response during streaming.
- 0f10482: [feat] Add
Features 2
Notes
Minor Changes
- c8c0e41: [Improvement] Add
gpt-5.4,gpt-5.4-nanoto the available model list. Remove deprecated modelo1(retirement date: 2026-06-18). - 75bb9a9: [Improvement] Added
mistralai--mistral-small,anthropic--claude-4.7-opus,gemini-3.1-flash-liteto the available model list.
- c8c0e41: [Improvement] Add
Features 1
Notes
Minor Changes
- 8cb466a: [Improvement] Remove deprecated models
amazon--titan-embed-imageandanthropic--claude-4.5-opus.
- 8cb466a: [Improvement] Remove deprecated models
Features 1
Notes
Minor Changes
- cd3d8ed: [Improvement] Add
gpt-5.2,anthropic--claude-4.5-opus,anthropic--claude-4.6-opus,anthropic--claude-4.6-sonnetandamazon-titan-embed-imageto the available model list. Removed deprecatedgpt-4omodel.
- cd3d8ed: [Improvement] Add
Features 1, Fixes 2
Notes
Minor Changes
- b12626b: [compat] Remove deprecated and retired models from model list.
Remove retired model
anthropic--claude-3-sonnetfrom model list, use suggested replacementanthropic--claude-4.5-sonnetinstead. Remove retired modelanthropic--claude-3-opusfrom model list. Remove deprecated modelgpt-4o-mini, use suggested replacementgpt-5-miniinstead. Remove deprecated modelsanthropic--claude-3.5-sonnetandanthropic--claude-3.7-sonnet.
Patch Changes
- b11b00c: [feat] Advertise AbortSignal support for HTTP request cancellation. This change adds typings, documentation and examples for using AbortSignal with the HTTP client to enable request cancellation.
- 56e9c3f: [Improvement] Combine 'ai-client-type' headers if a custom 'ai-client-type' header is set.
- b12626b: [compat] Remove deprecated and retired models from model list.
Remove retired model
Features 1
Notes
Minor Changes
- 2e1d2c2: [Improvement] Added
anthropic--claude-4.5-sonnet,anthropic--claude-4.5-haiku,gemini-2.5-flash-liteandsap-abap-1to the available model list. Removed deprecated modelsgemini-2.0-flashandgemini-2.0-flash-litescheduled for retirement.
- 2e1d2c2: [Improvement] Added
Features 2, Fixes 1
Notes
Minor Changes
- 6100bca: [Improvement] Add
cohere--command-a-reasoning,mistralai--mistral-medium-instructand perplexity-aisonarandsonar-proto model list - 347eac1: [New Functionality] Introduce orchestration embedding client for consuming embedding feature of the orchestration service.
Patch Changes
- 5225275: [Fixed Issue] Replace active logging during streaming with error throwing to avoid logging the response payload.
- 6100bca: [Improvement] Add
Features 1
Notes
Minor Changes
- 0cf7d80: [Improvement] Remove
alephalpha-pharia-1-7b-controlanddeepseek-ai--deepseek-r1from available model list.
- 0cf7d80: [Improvement] Remove
Features 1, Fixes 1
Notes
Minor Changes
- 500c0dd: [Improvement] Add
gpt-5,gpt-5-miniandgpt-5-nanoto and removegemini-1.5-flash,gemini-1.5-proandibm--granite-13b-chatfrom the available model list.
Patch Changes
- 9e1c43a: [Improvement] Add
anthropic--claude-4-opus,anthropic--claude-4-sonnet,amazon--nova-premier,gemini-2.5-flashandgemini-2.5-proto and removemistralai--mixtral-8x7b-instruct-v01,meta--llama3.1-70b-instruct,nvidia--llama-3.2-nv-embedqa-1b,amazon--titan-embed-text,gpt-4,amazon--titan-text-expressandamazon--titan-text-litefrom the available model list.
- 500c0dd: [Improvement] Add
Features 1
Notes
Minor Changes
- 5307dd0: [Improvement] Add
o3,gpt-4.1,gpt-4.1-mini,gpt-4.1-nano,o4-miniandmistralai--mistral-small-instructto available model list.
- 5307dd0: [Improvement] Add
Features 1
Notes
Minor Changes
- a6ba3af: [Improvement] Add
gemini-2.0-flash,gemini-2.0-flash-lite,anthropic--claude-3.7-sonnetanddeepseek-ai--deepseek-r1to and removegemini-1.0-profrom the available model list.
- a6ba3af: [Improvement] Add
Features 1
Notes
Minor Changes
- 627a152: [Compatibility Note] Removed deprecated models: -
text-embedding-ada-002, usetext-embedding-3-smallortext-embedding-3-largeinstead. -meta--llama3-70b-instruct, usemeta--llama3.1-70b-instructinstead. -gpt-35-turbo, usegpt-4o-miniinstead. -gpt-35-turbo-16k, usegpt-4o-miniinstead. -gpt-4-32k, usegpt-4oinstead.
- 627a152: [Compatibility Note] Removed deprecated models: -
Features 1
Notes
Minor Changes
- 6f28f47: [Improvement] Add
o1,o3-miniandalephalpha-pharia-1-7b-controlto the available model list.
- 6f28f47: [Improvement] Add
Fixes 1
Notes
Patch Changes
-
bfed500: [Fixed Issue] Add missing cause in the error object for failing HTTP requests by using
ErrorWithCause, providing more context for debugging.[Compatibility Note] Due to the introduction of
ErrorWithCause,AxiosErroris now wrapped inside thecauseproperty. For example, useerror.cause.response.datainstead oferror.response.datato access the error response from the server.
-
Features 1
Notes
Minor Changes
- b4a5506: [New Functionality] Add support for providing custom destination for AI Core besides using environment variable and service binding.
Features 1, Fixes 1
Notes
Minor Changes
- 771f986: [Fixed Issue] Fix sending the correct resource group headers when custom resource group is set.
Patch Changes
- 506a1e4: [Fixed Issue] Fix missing and unused dependencies.
Others providing
Compare all 23 on the LLM integration page →- llm_clientllm_clientAn ABAP client that gives chat-completion LLM APIs one interface for chat messages, structured output and tool calls across ten providers, from OpenAI and Anthropic to OLLAMA and AWS Bedrock.independent, abapABAP client with one interface to chat-completion LLM APIsfrom ABAP
- abap-agent-runtimeabap-agent-runtimeAn ABAP-native MCP endpoint inside the SAP system: an agent reads the screen of an opted-in abap2UI5 app as structured data, fills its fields and fires its events as the logged-on SAP user.community org, abapABAP-native MCP endpoint that drives opted-in abap2UI5 appsfrom ABAP
- abap_btocs_ollamaabap_btocs_ollamaAn ABAP plugin, built on the B-Tocs ABAP SDK, that calls models served by Ollama through an SM59 RFC destination, implementing four of its API endpoints: generate, tags, show and embeddings.independent, abapB-Tocs ABAP SDK plugin connecting to Ollama modelsfrom ABAP
- SAP AI CoreSAP AI CoreSAP's AI service on BTP: the runtime for AI assets, and through the Generative AI Hub inside it the access to foundation models, the orchestration service with its templating, masking, filtering and grounding modules, the Prompt Registry and Document Grounding.sap official, btpAI runtime on BTP with the Generative AI Hubfrom BTP/BAIP
- cap-java/cds-aicap-java/cds-aiBridges CAP Java to SAP AI Core and adds AI-powered field recommendations to Fiori draft UIs, as two alpha Maven modules with mock fallbacks for local development.sap official, capBridge from CAP Java to SAP AI Core, with Fiori field recommendationsfrom CAP
- @cap-js/ai@cap-js/aiOut-of-the-box value-help recommendations powered by SAP RPT-1, SAP AI Core as a standard CAP service, and an experimental local embedding model behind SQLite's vector functions.sap official, capValue-help recommendations and SAP AI Core as a CAP servicefrom CAP
- cap-llm-plugincap-llm-pluginGenerative AI in a CAP application with the sensitive fields anonymised through SAP HANA before the prompt leaves, so the model never sees the confidential half.independent, capGenerative AI in CAP with fields anonymised through SAP HANAfrom CAP
- @geertjanklaps/cds-toon-ai-protocol-adapter@geertjanklaps/cds-toon-ai-protocol-adapterA protocol adapter that serves CAP data as TOON — Token-Oriented Object Notation — instead of JSON, so a payload bound for a language model costs fewer tokens to send.independent, capProtocol adapter serving CAP data as TOON instead of JSONfrom CAP
- abap-sdk-nwas-xabap-sdk-nwas-xAn ABAP client library for IBM's watsonx.ai and watsonx.ai Runtime APIs, installed into an SAP NetWeaver AS ABAP system through abapGit, generating and refreshing the IAM token from an API key.independent, abapABAP client library for IBM watsonx.ai APIsfrom ABAP
- @jerome-benoit/sap-ai-provider@jerome-benoit/sap-ai-providerA provider for the Vercel AI SDK that speaks to SAP AI Core through its orchestration or foundation models API, so an application written against that SDK runs on SAP's models without being rewritten.independent, capVercel AI SDK provider for SAP AI Corefrom CAP
- ui5-cap-ai-featuresui5-cap-ai-featuresBoth halves of an AI text feature in one package: a CDS plugin serving an AIService over SAP AI Core's Orchestration Service, and the be.wl.ai UI5 control library that calls exactly that service.independent, capCDS plugin and UI5 controls for AI text features via SAP AI Corefrom CAP
- Microsoft AI SDK for SAPMicrosoft AI SDK for SAPMicrosoft's ABAP library for calling Azure OpenAI and OpenAI from an SAP application server, wrapping completions, embeddings, fine-tuning and the other operations in ABAP data types, installed with abapGit.partner, abapABAP library for calling Azure OpenAI and OpenAIfrom ABAP
- zllmzllmAn ABAP framework for chaining and orchestrating calls to large language models in pure ABAP, with templated prompts, routing by complexity, response caching and token estimation.independent, abapABAP framework for chaining and orchestrating LLM callsfrom ABAP
- ABAP AI SDKABAP AI SDKSAP's reuse library for calling a large language model from ABAP code, powered by Intelligent Scenario Lifecycle Management and reaching the models in the Generative AI Hub; delivered with SAP BTP ABAP environment, SAP S/4HANA Cloud Public and Private Edition and SAP S/4HANA.sap official, abapSAP reuse library for calling large language models from ABAPfrom ABAP
- @sap-ai-sdk/ai-api@sap-ai-sdk/ai-apiThe AI Core API surface of SAP's AI SDK, covering deployments, configurations and the rest of the control plane, as opposed to calling a model.sap official, capAI Core control plane API surface of SAP's AI SDKfrom CAP
- @sap-ai-sdk/foundation-models@sap-ai-sdk/foundation-modelsThe package of SAP's AI SDK that calls foundation models through SAP AI Core and the Generative AI Hub, and the one an application actually reaches for.sap official, capClient for foundation models via SAP AI Core and Generative AI Hubfrom CAP
- @sap-ai-sdk/orchestration@sap-ai-sdk/orchestrationThe Orchestration Service client of SAP's AI SDK, which applies templating, grounding, filtering and masking around a model call rather than in the application.sap official, capOrchestration Service client for templating, grounding and maskingfrom CAP
- @sap-ai-sdk/prompt-registry@sap-ai-sdk/prompt-registryA package for keeping prompts in SAP's prompt registry rather than in the codebase, so changing a prompt is not a deployment.sap official, capClient for prompts kept in SAP's prompt registryfrom CAP
- @saptarishi/cds-plugin-llm@saptarishi/cds-plugin-llmA CAP service kind that puts eleven model providers behind one chat, stream, embed and batch interface, so which backend a service calls is a profile in package.json rather than a change to the handler.independent, capCAP service kind putting eleven model providers behind one APIfrom CAP
- @shahid.la/cds-db-nlquery-mcp@shahid.la/cds-db-nlquery-mcpMCP server that answers plain-English questions against the entities in db/schema.cds — it discovers the schema, generates CQN-backed SQL with real joins, and returns rows.independent, capMCP server answering plain-English questions against a CDS schemafrom CAP
- @ui5/webcomponents@ui5/webcomponentsSAP's UI elements as standard custom elements, ui5-button among them, implementing SAP Fiori design and usable from plain HTML, React, Angular or Vue.sap official, ui5SAP's UI elements as standard custom elementsfrom UI5
- abap-sdk-nwasabap-sdk-nwasAn ABAP client library for IBM Watson's Discovery, Language Translator, Natural Language Understanding, Speech to Text, Text to Speech and Assistant services, installed through abapGit.independent, abapAn ABAP client library for IBM Watson's Discovery, Language Translator, Natural Language Understanding, Speech to Text, Text to Speech and Assistant services, installed through abapGit.from ABAP
Details
Sources
Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.
Compatibility and provenance
Contributors
History in the atlas
- Typed cds-plugin by placement, which defaults every candidate to that. It is not one.
- The shared internals of SAP's AI SDK, which its own readme says is not meant to be depended on directly.
- First seen.
For your agent
- Ref
artifact:sap-ai-sdk-core- JSON
- /artifacts/sap-ai-sdk-core.json
- MCP
- Connecting an agent