PackagePackagetypeA library you install and call yourself.See every one →What this type is →by SAPby SAPoriginPublished by SAP itself. A visible facet, never an input to a reading — a dormant official plugin reads exactly like a dormant independent one.See every one →

@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

Latestv2.17.0ReleasedLast pushLicenceApache-2.0

Where it sits

Lives in
Provides
LLM integrationCAPLLM integrationcapabilityCalling a language model from application code with the tenant, destination and credential handling already solved instead using an SDK call with a hand-rolled key.

Who is behind it

SAPSAPOrganisationMaintains this
In the atlas: maintains 137, wrote 14
@SAP
maintainerAnjanPersonContributes to this
In the atlas: contributes to 7
@anjan-poonacha
SAP Cloud SDK BotPersonContributes to this
In the atlas: contributes to 11
@bot-sdk-js
BrigittaK307PersonContributes to this
In the atlas: contributes to 12
@BrigittaK307
Charles DuboisPersonContributes to this
In the atlas: contributes to 5
@CharlesDuboisSAP
Christoph MatthiesPersonContributes to this
In the atlas: contributes to 5
@ChristophMatthies
David KnaackPersonContributes to this
In the atlas: contributes to 13, wrote 1
@davidkna-sap
Deeksha SinhaPersonContributes to this
In the atlas: contributes to 12
@deekshas8
Guilherme DellagustinPersonContributes to this
In the atlas: contributes to 27
@dellagustin-sap
emincihangeriPersonContributes to this
In the atlas: contributes to 12
@emincihangeri
Tian TengPersonContributes to this
In the atlas: contributes to 5
@Herrtian
21 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

Connections1

Install

npm add @sap-ai-sdk/core

Derived 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-js/packages/core/README.mdOn GitHub

@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.

Apache-2.0, read

History

Latest

v2.17.0

Features 3

Notes
Minor Changes
  • [feat] Add gemini-3.8-flash to the model types.

  • [feat] Add gpt-6-astra, gpt-6-luna, gpt-6.1-sol, gemini-3.6-flash, and nvidia--llama-nemotron-embed-1b to 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) — use mistralai--mistral-medium instead, gemini-2.5-flash-lite (retirement date: 2026-10-20) — use gemini-3.5-flash-lite instead, sap-rpt-1.5 (retirement date: 2026-12-31) — use sap-rpt-1.6 instead, sap-rpt-1.5-large (retirement date: 2026-12-31) — use sap-rpt-1.6-large instead, sap-rpt-1-small (retirement date: 2026-12-31) — use sap-rpt-1.6 instead and sap-rpt-1-large (retirement date: 2026-12-31) — use sap-rpt-1.6-large instead.

  1. v2.16.0

    Features 3, Fixes 1

    Notes
    Minor Changes
    • 0da56e2: [feat] Add LlmBatchModel type for models supported in LLM batch processing. BatchCreateRequest.spec.model now 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-luna to the available model list. Remove deprecated models gpt-4.1-nano (retirement date: 2026-10-14), gemini-2.5-flash (retirement date: 2026-10-16) and gemini-2.5-pro (retirement date: 2026-10-16).
    • 4b2c014: [feat] Add gemini-3.5-flash-lite to the available model list. Remove deprecated model mistralai--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 agentOptions or CustomRequestConfig.httpsAgent.
  2. v2.15.0

    Features 1

    Notes
    Minor Changes
    • a5407c8: [feat] Add experimental OpenAI Realtime API (speech-to-speech) support for gpt-realtime via the @sap-ai-sdk/openai/realtime sub-path export.
  3. v2.14.0

    Features 2

    Notes
    Minor Changes
    • cca7edd: [Improvement] Add anthropic--claude-4.5-opus, anthropic--claude-4.8-opus, gemini-3.5-flash, gemini-embedding to the available model list.
    • cca7edd: [feat] Add GcpVertexAiEmbeddingModel type with gemini-embedding to @sap-ai-sdk/core. Add GcpVertexAiEmbeddingModel to the EmbeddingModel union in @sap-ai-sdk/orchestration.
  4. v2.13.0

    Features 4

    Notes
    Minor Changes
    • 11baf52: [Improvement] Remove deprecated models mistralai--mistral-small-instruct (retirement date: not earlier than 2026-09-30) — use mistralai--mistral-small instead, amazon--nova-premier (retirement date: 2026-09-10) — use amazon--nova-lite (version: 2) instead, anthropic--claude-3-haiku (retirement date: 2026-09-10) — use anthropic--claude-4.5-haiku instead and anthropic--claude-4-sonnet (retirement date: 2026-10-14) — use anthropic--claude-4.5-sonnet instead.
    • cb8ffe7: [Improvement] Added gpt-5.1 to 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) and o4-mini (retirement date: 2026-10-16).
    • 6542a2a: [feat] Add toReadableStream() method to SseStream. The new method converts the asynchronous iterable stream to a pull-based ReadableStream of newline-delimited JSON, enabling composable transformations via the Web Streams API pipeThrough() pattern with native flow control.
  5. v2.12.0

    Features 2, Fixes 1

    Notes
    Minor Changes
    • 0f10482: [feat] Add AzureOpenAiResponsesModel type for Azure OpenAI models that exclusively support the Responses API.
    • e944aa1: [Improvement] Added gpt-5.5 to the available model list. Remove retired model anthropic--claude-4-opus — use anthropic--claude-4.7-opus instead. Remove deprecated model o3-mini (retirement date: 2026-08-02).
    Patch Changes
    • 2faf4a8: [fix] Improve error message when server sends a non-JSON response during streaming.
  6. v2.11.0

    Features 2

    Notes
    Minor Changes
    • c8c0e41: [Improvement] Add gpt-5.4, gpt-5.4-nano to the available model list. Remove deprecated model o1 (retirement date: 2026-06-18).
    • 75bb9a9: [Improvement] Added mistralai--mistral-small, anthropic--claude-4.7-opus, gemini-3.1-flash-lite to the available model list.
  7. v2.10.0

    Features 1

    Notes
    Minor Changes
    • 8cb466a: [Improvement] Remove deprecated models amazon--titan-embed-image and anthropic--claude-4.5-opus.
  8. v2.9.0

    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-sonnet and amazon-titan-embed-image to the available model list. Removed deprecated gpt-4o model.
  9. v2.8.0

  10. v2.7.0

    Features 1, Fixes 2

    Notes
    Minor Changes
    • b12626b: [compat] Remove deprecated and retired models from model list. Remove retired model anthropic--claude-3-sonnet from model list, use suggested replacement anthropic--claude-4.5-sonnet instead. Remove retired model anthropic--claude-3-opus from model list. Remove deprecated model gpt-4o-mini, use suggested replacement gpt-5-mini instead. Remove deprecated models anthropic--claude-3.5-sonnet and anthropic--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.
  11. v2.6.0

  12. v2.5.0

  13. v2.4.0

    Features 1

    Notes
    Minor Changes
    • 2e1d2c2: [Improvement] Added anthropic--claude-4.5-sonnet , anthropic--claude-4.5-haiku , gemini-2.5-flash-lite and sap-abap-1 to the available model list. Removed deprecated models gemini-2.0-flash and gemini-2.0-flash-lite scheduled for retirement.
  14. v2.3.0

  15. v2.2.0

    Features 2, Fixes 1

    Notes
    Minor Changes
    • 6100bca: [Improvement] Add cohere--command-a-reasoning, mistralai--mistral-medium-instruct and perplexity-ai sonar and sonar-pro to 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.
  16. v2.1.0

    Features 1

    Notes
    Minor Changes
    • 0cf7d80: [Improvement] Remove alephalpha-pharia-1-7b-control and deepseek-ai--deepseek-r1 from available model list.
  17. v2.0.0

    Features 1, Fixes 1

    Notes
    Minor Changes
    • 500c0dd: [Improvement] Add gpt-5,gpt-5-mini and gpt-5-nano to and remove gemini-1.5-flash, gemini-1.5-pro and ibm--granite-13b-chat from the available model list.
    Patch Changes
    • 9e1c43a: [Improvement] Add anthropic--claude-4-opus, anthropic--claude-4-sonnet, amazon--nova-premier, gemini-2.5-flash and gemini-2.5-pro to and remove mistralai--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-express and amazon--titan-text-lite from the available model list.
  18. v1.17.0

  19. v1.16.0

  20. v1.15.0

    Features 1

    Notes
    Minor Changes
    • 5307dd0: [Improvement] Add o3, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano, o4-mini and mistralai--mistral-small-instruct to available model list.
  21. v1.14.0

  22. v1.13.0

    Features 1

    Notes
    Minor Changes
    • a6ba3af: [Improvement] Add gemini-2.0-flash, gemini-2.0-flash-lite, anthropic--claude-3.7-sonnet and deepseek-ai--deepseek-r1 to and remove gemini-1.0-pro from the available model list.
  23. v1.12.0

  24. v1.11.0

    Features 1

    Notes
    Minor Changes
    • 627a152: [Compatibility Note] Removed deprecated models: - text-embedding-ada-002, use text-embedding-3-small or text-embedding-3-large instead. - meta--llama3-70b-instruct, use meta--llama3.1-70b-instruct instead. - gpt-35-turbo, use gpt-4o-mini instead. - gpt-35-turbo-16k, use gpt-4o-mini instead. - gpt-4-32k, use gpt-4o instead.
  25. v1.10.0

    Features 1

    Notes
    Minor Changes
    • 6f28f47: [Improvement] Add o1, o3-mini and alephalpha-pharia-1-7b-control to the available model list.
  26. v1.9.0

    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, AxiosError is now wrapped inside the cause property. For example, use error.cause.response.data instead of error.response.data to access the error response from the server.

  27. v1.8.0

  28. v1.7.0

  29. v1.6.0

  30. v1.5.0

    Features 1

    Notes
    Minor Changes
    • b4a5506: [New Functionality] Add support for providing custom destination for AI Core besides using environment variable and service binding.
  31. v1.4.0

  32. v1.3.0

  33. v1.2.0

  34. v1.1.0

    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.
  35. v1.0.0

  36. v0.1.0

26,890downloads per week, npm
Weekly downloads for @sap-ai-sdk/core26 complete calendar weeks from 2026-04-27 to 2026-10-25; the latest total is 26890.27 Apr – 3 May: 28,1694 May – 10 May: 31,36811 May – 17 May: 35,94318 May – 24 May: 31,91725 May – 31 May: 36,7051 Jun – 7 Jun: 61,4108 Jun – 14 Jun: 103,36715 Jun – 21 Jun: 70,20922 Jun – 28 Jun: 78,31729 Jun – 5 Jul: 70,7826 Jul – 12 Jul: 69,07113 Jul – 19 Jul: 211,09020 Jul – 26 Jul: 123,75827 Jul – 2 Aug: 173,5023 Aug – 9 Aug: 144,58210 Aug – 16 Aug: 134,97817 Aug – 23 Aug: 175,54724 Aug – 30 Aug: 166,01931 Aug – 6 Sept: 122,5487 Sept – 13 Sept: 117,99814 Sept – 20 Sept: 122,53921 Sept – 27 Sept: 160,31528 Sept – 4 Oct: 207,8105 Oct – 11 Oct: 137,50012 Oct – 18 Oct: 73,51819 Oct – 25 Oct: 26,890
LLM integration
  1. SAP AI CoreAI runtime on BTP with the Generative AI Hub
  2. cap-java/cds-aiBridge from CAP Java to SAP AI Core, with Fiori field recommendations
  3. @cap-js/aiValue-help recommendations and SAP AI Core as a CAP service
  4. cap-llm-pluginGenerative AI in CAP with fields anonymised through SAP HANA
  5. @geertjanklaps/cds-toon-ai-protocol-adapterProtocol adapter serving CAP data as TOON instead of JSON
  6. @jerome-benoit/sap-ai-providerVercel AI SDK provider for SAP AI Core
  7. ui5-cap-ai-featuresCDS plugin and UI5 controls for AI text features via SAP AI Core
  8. @sap-ai-sdk/ai-apiAI Core control plane API surface of SAP's AI SDK
  9. @sap-ai-sdk/foundation-modelsClient for foundation models via SAP AI Core and Generative AI Hub
  10. @sap-ai-sdk/orchestrationOrchestration Service client for templating, grounding and masking
  11. @sap-ai-sdk/prompt-registryClient for prompts kept in SAP's prompt registry
  12. @saptarishi/cds-plugin-llmCAP service kind putting eleven model providers behind one API
  13. @shahid.la/cds-db-nlquery-mcpMCP server answering plain-English questions against a CDS schema

Details

Sources5
npm registrydiscovered herechecked
The discovery passdiscovered herechecked
npm registry, @sap-ai-sdk/coreversion, releases, installschecked
github.com/https://github.com/SAP/ai-sdk-jstree, pushes, contributors, CIchecked
packages/core/README.mdquoted, and what the entry declareschecked

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
latestv2.17.0
first release
releases and cadence815, ~0d median
discovered vianpm registry, The discovery pass
first seen in the atlas
ecosystem and domaincap, ai-and-agents
Contributors21
History in the atlas3
  1. Typed cds-plugin by placement, which defaults every candidate to that. It is not one.
  2. The shared internals of SAP's AI SDK, which its own readme says is not meant to be depended on directly.
  3. First seen.
For your agent
Ref
artifact:sap-ai-sdk-core
JSON
/artifacts/sap-ai-sdk-core.json
MCP
Connecting an agent