@mcp-abap-adt/sap-aicore-embedder 11.0.0 → 11.1.0

package/README.md

@@ -31,14 +31,44 @@ console.log(results.map(r => r.vector));
 
 ## Configuration
 
-### SapAiCoreEmbedderConfig
+```ts
+interface SapAiCoreEmbedderConfig {
+  model: string;
+  resourceGroup?: string;                             // default: 'default'
+  scenario?: 'foundation-models' | 'orchestration';   // default: 'orchestration'
+  credentials?: FoundationModelsCredentials;          // foundation-models only; falls back to AICORE_SERVICE_KEY
+}
+```
+
+### Orchestration (default)
+
+The default scenario — matches v11.0.0 behavior. Use this when the embedding model is deployed under the `orchestration` scenario. Authentication is handled automatically by the SAP AI SDK orchestration client using `AICORE_SERVICE_KEY`.
+
+```ts
+import { SapAiCoreEmbedder } from '@mcp-abap-adt/sap-aicore-embedder';
+
+const embedder = new SapAiCoreEmbedder({ model: 'text-embedding-3-small' });
+```
 
-- `model` (required): Embedding model name (e.g., 'text-embedding-3-small')
-- `resourceGroup` (optional): SAP AI Core resource group
+Existing v11.0.0 consumers require no config changes.
+
+### Foundation-models
+
+Opt-in path for tenants where embedding models (such as `gemini-embedding` or `text-embedding-3-small`) are deployed under the `foundation-models` scenario rather than the orchestration scenario. The embedder calls the AI Core REST inference API directly.
+
+```ts
+const embedder = new SapAiCoreEmbedder({
+  model: 'gemini-embedding',
+  scenario: 'foundation-models',
+});
+// Auth: process.env.AICORE_SERVICE_KEY (client_credentials flow)
+```
 
 ## Authentication
 
-Authentication uses the `AICORE_SERVICE_KEY` environment variable, which is read automatically by the SAP AI SDK orchestration client.
+For the `orchestration` scenario (default), authentication is handled automatically by the SAP AI SDK orchestration client using `AICORE_SERVICE_KEY`.
+
+For the `foundation-models` scenario, authentication uses the `AICORE_SERVICE_KEY` environment variable directly (client credentials flow). You can also pass credentials explicitly via the `credentials` option.
 
 ## License
 

package/dist/auth.d.ts

@@ -0,0 +1,23 @@
+export interface TokenProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    tokenUrl: string;
+}
+export interface GetTokenOptions {
+    /**
+     * Skip the local expiry cache. Note: if another `getToken()` call is already
+     * fetching a token, this flag coalesces into that in-flight request rather
+     * than starting a second one.
+     */
+    forceRefresh?: boolean;
+}
+export declare class TokenProvider {
+    private readonly cfg;
+    private cachedToken;
+    private cachedExpiryMs;
+    private inFlight;
+    constructor(cfg: TokenProviderConfig);
+    getToken(options?: GetTokenOptions): Promise<string>;
+    private fetchToken;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAKD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,GAAG,EAAE,mBAAmB;IAI9B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;YAwB5C,UAAU;CA+BzB"}

package/dist/auth.js

@@ -0,0 +1,56 @@
+/** Refresh the token when less than this many ms remain on it. */
+const REFRESH_WINDOW_MS = 60_000;
+export class TokenProvider {
+    cfg;
+    cachedToken = null;
+    cachedExpiryMs = 0;
+    inFlight = null;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    async getToken(options) {
+        if (!options?.forceRefresh &&
+            this.cachedToken &&
+            Date.now() < this.cachedExpiryMs - REFRESH_WINDOW_MS) {
+            return this.cachedToken;
+        }
+        // Dedupe concurrent callers, including those with forceRefresh (see GetTokenOptions).
+        if (this.inFlight)
+            return this.inFlight;
+        this.inFlight = this.fetchToken()
+            .then((result) => {
+            this.cachedToken = result.token;
+            this.cachedExpiryMs = Date.now() + result.expiresInMs;
+            return result.token;
+        })
+            .finally(() => {
+            this.inFlight = null;
+        });
+        return this.inFlight;
+    }
+    async fetchToken() {
+        const basic = Buffer.from(`${this.cfg.clientId}:${this.cfg.clientSecret}`).toString('base64');
+        const res = await fetch(this.cfg.tokenUrl, {
+            method: 'POST',
+            headers: {
+                Authorization: `Basic ${basic}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Accept: 'application/json',
+            },
+            body: 'grant_type=client_credentials',
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new Error(`SAP AI Core token request failed: ${res.status} ${res.statusText} ${text}`);
+        }
+        const body = (await res.json());
+        if (!body.access_token) {
+            throw new Error('SAP AI Core token response missing access_token');
+        }
+        return {
+            token: body.access_token,
+            expiresInMs: (body.expires_in ?? 3600) * 1000,
+        };
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAeA,kEAAkE;AAClE,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,MAAM,OAAO,aAAa;IACP,GAAG,CAAsB;IAClC,WAAW,GAAkB,IAAI,CAAC;IAClC,cAAc,GAAG,CAAC,CAAC;IACnB,QAAQ,GAA2B,IAAI,CAAC;IAEhD,YAAY,GAAwB;QAClC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAyB;QACtC,IACE,CAAC,OAAO,EAAE,YAAY;YACtB,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,GAAG,iBAAiB,EACpD,CAAC;YACD,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QACD,sFAAsF;QACtF,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QAExC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE;aAC9B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;YAChC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;YACtD,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC,CAAC,CAAC;QAEL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CACvB,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAChD,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS,KAAK,EAAE;gBAC/B,cAAc,EAAE,mCAAmC;gBACnD,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,+BAA+B;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,qCAAqC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,CAC5E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,WAAW,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,IAAI;SAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/decode-embedding.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decode an embedding vector from either a `number[]` (JSON array) or a
+ * base64-encoded Float32 buffer string (compact on-wire form some SAP AI Core
+ * deployments return).
+ */
+export declare function decodeEmbedding(embedding: number[] | string): number[];
+//# sourceMappingURL=decode-embedding.d.ts.map

package/dist/decode-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-embedding.d.ts","sourceRoot":"","sources":["../src/decode-embedding.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,CAWtE"}

package/dist/decode-embedding.js

@@ -0,0 +1,15 @@
+// packages/sap-aicore-embedder/src/decode-embedding.ts
+/**
+ * Decode an embedding vector from either a `number[]` (JSON array) or a
+ * base64-encoded Float32 buffer string (compact on-wire form some SAP AI Core
+ * deployments return).
+ */
+export function decodeEmbedding(embedding) {
+    if (typeof embedding === 'string') {
+        const buffer = Buffer.from(embedding, 'base64');
+        const float32 = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
+        return Array.from(float32);
+    }
+    return embedding;
+}
+//# sourceMappingURL=decode-embedding.js.map

package/dist/decode-embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-embedding.js","sourceRoot":"","sources":["../src/decode-embedding.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAA4B;IAC1D,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,MAAM,GAAG,CAAC,CAClB,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/deployments.d.ts

@@ -0,0 +1,10 @@
+export interface ResolveDeploymentOptions {
+    apiBaseUrl: string;
+    token: string;
+    resourceGroup: string;
+    model: string;
+    /** Scenario id. Default: 'foundation-models'. */
+    scenarioId?: string;
+}
+export declare function resolveDeploymentId(options: ResolveDeploymentOptions): Promise<string>;
+//# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwBD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CA2BjB"}

package/dist/deployments.js

@@ -0,0 +1,27 @@
+function extractModelName(resource) {
+    return (resource.details?.resources?.backend_details?.model?.name ??
+        resource.model?.name);
+}
+export async function resolveDeploymentId(options) {
+    const scenarioId = options.scenarioId ?? 'foundation-models';
+    const url = `${options.apiBaseUrl}/v2/lm/deployments?scenarioId=${encodeURIComponent(scenarioId)}&status=RUNNING`;
+    const res = await fetch(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${options.token}`,
+            'AI-Resource-Group': options.resourceGroup,
+            Accept: 'application/json',
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`SAP AI Core deployment list failed: ${res.status} ${res.statusText} ${text}`);
+    }
+    const body = (await res.json());
+    const match = (body.resources ?? []).find((r) => extractModelName(r) === options.model && typeof r.id === 'string');
+    if (!match?.id) {
+        throw new Error(`No RUNNING deployment found for model "${options.model}" in scenario "${scenarioId}"`);
+    }
+    return match.id;
+}
+//# sourceMappingURL=deployments.js.map

package/dist/deployments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAwBA,SAAS,gBAAgB,CAAC,QAA4B;IACpD,OAAO,CACL,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI;QACzD,QAAQ,CAAC,KAAK,EAAE,IAAI,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAiC;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,iCAAiC,kBAAkB,CAAC,UAAU,CAAC,iBAAiB,CAAC;IAClH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE;YACxC,mBAAmB,EAAE,OAAO,CAAC,aAAa;YAC1C,MAAM,EAAE,kBAAkB;SAC3B;KACF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,uCAAuC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;IAC1D,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CACzE,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0CAA0C,OAAO,CAAC,KAAK,kBAAkB,UAAU,GAAG,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,CAAC;AAClB,CAAC"}

package/dist/foundation-embedder.d.ts

@@ -0,0 +1,35 @@
+import type { IEmbedderBatch, IEmbedResult } from '@mcp-abap-adt/llm-agent';
+import { type CallOptions } from '@mcp-abap-adt/llm-agent';
+export interface FoundationModelsCredentials {
+    clientId: string;
+    clientSecret: string;
+    tokenUrl: string;
+    apiBaseUrl: string;
+}
+export interface FoundationModelsEmbedderConfig {
+    model: string;
+    resourceGroup?: string;
+    /** Explicit credentials. When omitted, `AICORE_SERVICE_KEY` env var is parsed. */
+    credentials?: FoundationModelsCredentials;
+    /**
+     * Azure OpenAI api-version query parameter for OpenAI-family deployments.
+     * Default: '2023-05-15'. Ignored for Gemini-family models.
+     */
+    azureApiVersion?: string;
+}
+export declare class FoundationModelsEmbedder implements IEmbedderBatch {
+    private readonly model;
+    private readonly family;
+    private readonly azureApiVersion;
+    private readonly resourceGroup;
+    private readonly apiBaseUrl;
+    private readonly tokenProvider;
+    private deploymentIdPromise;
+    constructor(config: FoundationModelsEmbedderConfig);
+    embed(text: string, _options?: CallOptions): Promise<IEmbedResult>;
+    embedBatch(texts: string[], _options?: CallOptions): Promise<IEmbedResult[]>;
+    private requestEmbeddings;
+    private getDeploymentId;
+    private loadCredentialsFromEnv;
+}
+//# sourceMappingURL=foundation-embedder.d.ts.map

package/dist/foundation-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-embedder.d.ts","sourceRoot":"","sources":["../src/foundation-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,yBAAyB,CAAC;AAMrE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,mBAAmB,CAAgC;gBAE/C,MAAM,EAAE,8BAA8B;IAc5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAQlE,UAAU,CACd,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;YAUZ,iBAAiB;IAoD/B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,sBAAsB;CAS/B"}

package/dist/foundation-embedder.js

@@ -0,0 +1,114 @@
+import { RagError } from '@mcp-abap-adt/llm-agent';
+import { TokenProvider } from './auth.js';
+import { decodeEmbedding } from './decode-embedding.js';
+import { resolveDeploymentId } from './deployments.js';
+import { parseServiceKey } from './service-key.js';
+export class FoundationModelsEmbedder {
+    model;
+    family;
+    azureApiVersion;
+    resourceGroup;
+    apiBaseUrl;
+    tokenProvider;
+    deploymentIdPromise = null;
+    constructor(config) {
+        const creds = config.credentials ?? this.loadCredentialsFromEnv();
+        this.model = config.model;
+        this.family = detectFamily(config.model);
+        this.azureApiVersion = config.azureApiVersion ?? '2023-05-15';
+        this.resourceGroup = config.resourceGroup ?? 'default';
+        this.apiBaseUrl = creds.apiBaseUrl;
+        this.tokenProvider = new TokenProvider({
+            clientId: creds.clientId,
+            clientSecret: creds.clientSecret,
+            tokenUrl: creds.tokenUrl,
+        });
+    }
+    async embed(text, _options) {
+        const items = await this.requestEmbeddings([text]);
+        if (items.length === 0) {
+            throw new RagError('No embeddings returned from SAP AI Core');
+        }
+        return { vector: decodeEmbedding(items[0].embedding) };
+    }
+    async embedBatch(texts, _options) {
+        if (texts.length === 0)
+            return [];
+        const items = await this.requestEmbeddings(texts);
+        if (items.length === 0) {
+            throw new RagError('No embeddings returned from SAP AI Core batch');
+        }
+        const sorted = [...items].sort((a, b) => a.index - b.index);
+        return sorted.map((item) => ({ vector: decodeEmbedding(item.embedding) }));
+    }
+    async requestEmbeddings(input) {
+        const token = await this.tokenProvider.getToken();
+        const deploymentId = await this.getDeploymentId(token);
+        const base = `${this.apiBaseUrl}/v2/inference/deployments/${deploymentId}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            'AI-Resource-Group': this.resourceGroup,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (this.family === 'gemini') {
+            const url = `${base}/models/${encodeURIComponent(this.model)}:predict`;
+            const body = {
+                instances: input.map((content) => ({ content })),
+            };
+            const res = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                const text = await res.text().catch(() => '');
+                throw new RagError(`SAP AI Core embeddings call failed: ${res.status} ${res.statusText} ${text}`);
+            }
+            const json = (await res.json());
+            return (json.predictions ?? []).map((p, i) => ({
+                embedding: p.embeddings?.values ?? [],
+                index: i,
+            }));
+        }
+        // azure-openai
+        const url = `${base}/embeddings?api-version=${encodeURIComponent(this.azureApiVersion)}`;
+        const body = { input: input.length === 1 ? input[0] : input };
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new RagError(`SAP AI Core embeddings call failed: ${res.status} ${res.statusText} ${text}`);
+        }
+        const json = (await res.json());
+        return json.data ?? [];
+    }
+    getDeploymentId(token) {
+        if (!this.deploymentIdPromise) {
+            this.deploymentIdPromise = resolveDeploymentId({
+                apiBaseUrl: this.apiBaseUrl,
+                token,
+                resourceGroup: this.resourceGroup,
+                model: this.model,
+            }).catch((err) => {
+                this.deploymentIdPromise = null;
+                throw err;
+            });
+        }
+        return this.deploymentIdPromise;
+    }
+    loadCredentialsFromEnv() {
+        const raw = process.env.AICORE_SERVICE_KEY;
+        if (!raw) {
+            throw new Error('SapAiCoreEmbedder (foundation-models): no credentials provided and AICORE_SERVICE_KEY env var is not set');
+        }
+        return parseServiceKey(raw);
+    }
+}
+function detectFamily(model) {
+    return /^gemini/i.test(model) ? 'gemini' : 'azure-openai';
+}
+//# sourceMappingURL=foundation-embedder.js.map

package/dist/foundation-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-embedder.js","sourceRoot":"","sources":["../src/foundation-embedder.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export type { SapAiCoreEmbedderConfig } from './sap-ai-core-embedder.js';
+export type { FoundationModelsCredentials, SapAiCoreEmbedderConfig, SapAiCoreEmbedderScenario, } from './sap-ai-core-embedder.js';
 export { SapAiCoreEmbedder } from './sap-ai-core-embedder.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/orchestration-embedder.d.ts

@@ -0,0 +1,15 @@
+import type { IEmbedderBatch, IEmbedResult } from '@mcp-abap-adt/llm-agent';
+import { type CallOptions } from '@mcp-abap-adt/llm-agent';
+export interface OrchestrationScenarioEmbedderConfig {
+    model: string;
+    resourceGroup?: string;
+}
+export declare class OrchestrationScenarioEmbedder implements IEmbedderBatch {
+    private readonly model;
+    private readonly resourceGroup?;
+    constructor(config: OrchestrationScenarioEmbedderConfig);
+    embed(text: string, _options?: CallOptions): Promise<IEmbedResult>;
+    embedBatch(texts: string[], _options?: CallOptions): Promise<IEmbedResult[]>;
+    private createClient;
+}
+//# sourceMappingURL=orchestration-embedder.d.ts.map

package/dist/orchestration-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-embedder.d.ts","sourceRoot":"","sources":["../src/orchestration-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,yBAAyB,CAAC;AAGrE,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,6BAA8B,YAAW,cAAc;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,mCAAmC;IAKjD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAUlE,UAAU,CACd,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;YAYZ,YAAY;CAW3B"}

package/dist/orchestration-embedder.js

@@ -0,0 +1,38 @@
+import { RagError } from '@mcp-abap-adt/llm-agent';
+import { decodeEmbedding } from './decode-embedding.js';
+export class OrchestrationScenarioEmbedder {
+    model;
+    resourceGroup;
+    constructor(config) {
+        this.model = config.model;
+        this.resourceGroup = config.resourceGroup;
+    }
+    async embed(text, _options) {
+        const client = await this.createClient();
+        const response = await client.embed({ input: text });
+        const embeddings = response.getEmbeddings();
+        if (!embeddings || embeddings.length === 0) {
+            throw new RagError('No embeddings returned from SAP AI Core');
+        }
+        return { vector: decodeEmbedding(embeddings[0].embedding) };
+    }
+    async embedBatch(texts, _options) {
+        if (texts.length === 0)
+            return [];
+        const client = await this.createClient();
+        const response = await client.embed({ input: texts });
+        const embeddings = response.getEmbeddings();
+        if (!embeddings || embeddings.length === 0) {
+            throw new RagError('No embeddings returned from SAP AI Core batch');
+        }
+        const sorted = [...embeddings].sort((a, b) => a.index - b.index);
+        return sorted.map((e) => ({ vector: decodeEmbedding(e.embedding) }));
+    }
+    async createClient() {
+        const { OrchestrationEmbeddingClient } = await import('@sap-ai-sdk/orchestration');
+        const modelName = this
+            .model;
+        return new OrchestrationEmbeddingClient({ embeddings: { model: { name: modelName } } }, this.resourceGroup ? { resourceGroup: this.resourceGroup } : undefined);
+    }
+}
+//# sourceMappingURL=orchestration-embedder.js.map

package/dist/orchestration-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-embedder.js","sourceRoot":"","sources":["../src/orchestration-embedder.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxD,MAAM,OAAO,6BAA6B;IACvB,KAAK,CAAS;IACd,aAAa,CAAU;IAExC,YAAY,MAA2C;QACrD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,QAAsB;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC5C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,QAAQ,CAAC,yCAAyC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAe,EACf,QAAsB;QAEtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC5C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,QAAQ,CAAC,+CAA+C,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,EAAE,4BAA4B,EAAE,GAAG,MAAM,MAAM,CACnD,2BAA2B,CAC5B,CAAC;QACF,MAAM,SAAS,GAAG,IAAI;aACnB,KAAsE,CAAC;QAC1E,OAAO,IAAI,4BAA4B,CACrC,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAC9C,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CACvE,CAAC;IACJ,CAAC;CACF"}

package/dist/sap-ai-core-embedder.d.ts

@@ -1,22 +1,33 @@
-/**
- * SAP AI Core Embedder — IEmbedderBatch implementation using @sap-ai-sdk/orchestration.
- *
- * Generates text embeddings via SAP AI Core embedding model deployments.
- * Authentication: reads AICORE_SERVICE_KEY env var automatically (same as LLM provider).
- */
-import type { IEmbedderBatch, IEmbedResult } from '@mcp-abap-adt/llm-agent';
-import { type CallOptions } from '@mcp-abap-adt/llm-agent';
+import type { CallOptions, IEmbedderBatch, IEmbedResult } from '@mcp-abap-adt/llm-agent';
+import { type FoundationModelsCredentials } from './foundation-embedder.js';
+export type SapAiCoreEmbedderScenario = 'foundation-models' | 'orchestration';
 export interface SapAiCoreEmbedderConfig {
-    /** Embedding model name (e.g. 'text-embedding-3-small') */
+    /** Embedding model name (e.g. 'text-embedding-3-small', 'gemini-embedding') */
     model: string;
-    /** SAP AI Core resource group (optional) */
+    /** SAP AI Core resource group. Default: 'default'. */
     resourceGroup?: string;
+    /**
+     * SAP AI Core scenario under which the embedding model is deployed.
+     * - `'orchestration'` (default): uses `OrchestrationEmbeddingClient` from `@sap-ai-sdk/orchestration`.
+     *   Requires an orchestration-scenario deployment of the embedding model. This matches v11.0.0 behavior.
+     * - `'foundation-models'`: calls the AI Core REST inference API directly.
+     *   Use this when your embedding models are deployed under the foundation-models scenario
+     *   (common for tenants where SAP AI Core embedders such as `gemini-embedding` and `text-embedding-3-small`
+     *   are deployed outside the orchestration scenario).
+     */
+    scenario?: SapAiCoreEmbedderScenario;
+    /**
+     * Explicit credentials for the `foundation-models` scenario.
+     * When omitted, `AICORE_SERVICE_KEY` env var is parsed instead.
+     * Ignored for `scenario: 'orchestration'` (the SAP SDK handles auth there).
+     */
+    credentials?: FoundationModelsCredentials;
 }
+export type { FoundationModelsCredentials };
 export declare class SapAiCoreEmbedder implements IEmbedderBatch {
-    private readonly model;
-    private readonly resourceGroup?;
+    private readonly backend;
     constructor(config: SapAiCoreEmbedderConfig);
-    embed(text: string, _options?: CallOptions): Promise<IEmbedResult>;
-    embedBatch(texts: string[], _options?: CallOptions): Promise<IEmbedResult[]>;
+    embed(text: string, options?: CallOptions): Promise<IEmbedResult>;
+    embedBatch(texts: string[], options?: CallOptions): Promise<IEmbedResult[]>;
 }
 //# sourceMappingURL=sap-ai-core-embedder.d.ts.map

package/dist/sap-ai-core-embedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sap-ai-core-embedder.d.ts","sourceRoot":"","sources":["../src/sap-ai-core-embedder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,uBAAuB;IAKrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAmClE,UAAU,CACd,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;CAmC3B"}
+{"version":3,"file":"sap-ai-core-embedder.d.ts","sourceRoot":"","sources":["../src/sap-ai-core-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAE9E,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC;;;;OAIG;IACH,WAAW,CAAC,EAAE,2BAA2B,CAAC;CAC3C;AAED,YAAY,EAAE,2BAA2B,EAAE,CAAC;AAE5C,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,MAAM,EAAE,uBAAuB;IAgB3C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAG5E"}

package/dist/sap-ai-core-embedder.js

@@ -1,57 +1,28 @@
-/**
- * SAP AI Core Embedder — IEmbedderBatch implementation using @sap-ai-sdk/orchestration.
- *
- * Generates text embeddings via SAP AI Core embedding model deployments.
- * Authentication: reads AICORE_SERVICE_KEY env var automatically (same as LLM provider).
- */
-import { RagError } from '@mcp-abap-adt/llm-agent';
+import { FoundationModelsEmbedder, } from './foundation-embedder.js';
+import { OrchestrationScenarioEmbedder } from './orchestration-embedder.js';
 export class SapAiCoreEmbedder {
-    model;
-    resourceGroup;
+    backend;
     constructor(config) {
-        this.model = config.model;
-        this.resourceGroup = config.resourceGroup;
-    }
-    async embed(text, _options) {
-        const { OrchestrationEmbeddingClient } = await import('@sap-ai-sdk/orchestration');
-        const modelName = this
-            .model;
-        const client = new OrchestrationEmbeddingClient({ embeddings: { model: { name: modelName } } }, this.resourceGroup ? { resourceGroup: this.resourceGroup } : undefined);
-        const response = await client.embed({ input: text });
-        const embeddings = response.getEmbeddings();
-        if (!embeddings || embeddings.length === 0) {
-            throw new RagError('No embeddings returned from SAP AI Core');
+        const scenario = config.scenario ?? 'orchestration';
+        if (scenario === 'orchestration') {
+            this.backend = new OrchestrationScenarioEmbedder({
+                model: config.model,
+                resourceGroup: config.resourceGroup,
+            });
         }
-        const embedding = embeddings[0].embedding;
-        // Handle base64-encoded embeddings
-        if (typeof embedding === 'string') {
-            const buffer = Buffer.from(embedding, 'base64');
-            const float32 = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
-            return { vector: Array.from(float32) };
+        else {
+            this.backend = new FoundationModelsEmbedder({
+                model: config.model,
+                resourceGroup: config.resourceGroup,
+                credentials: config.credentials,
+            });
         }
-        return { vector: embedding };
     }
-    async embedBatch(texts, _options) {
-        if (texts.length === 0)
-            return [];
-        const { OrchestrationEmbeddingClient } = await import('@sap-ai-sdk/orchestration');
-        const modelName = this
-            .model;
-        const client = new OrchestrationEmbeddingClient({ embeddings: { model: { name: modelName } } }, this.resourceGroup ? { resourceGroup: this.resourceGroup } : undefined);
-        const response = await client.embed({ input: texts });
-        const embeddings = response.getEmbeddings();
-        if (!embeddings || embeddings.length === 0) {
-            throw new RagError('No embeddings returned from SAP AI Core batch');
-        }
-        const sorted = [...embeddings].sort((a, b) => a.index - b.index);
-        return sorted.map((e) => {
-            if (typeof e.embedding === 'string') {
-                const buffer = Buffer.from(e.embedding, 'base64');
-                const float32 = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
-                return { vector: Array.from(float32) };
-            }
-            return { vector: e.embedding };
-        });
+    embed(text, options) {
+        return this.backend.embed(text, options);
+    }
+    embedBatch(texts, options) {
+        return this.backend.embedBatch(texts, options);
     }
 }
 //# sourceMappingURL=sap-ai-core-embedder.js.map

package/dist/sap-ai-core-embedder.js.map

@@ -1 +1 @@
-{"version":3,"file":"sap-ai-core-embedder.js","sourceRoot":"","sources":["../src/sap-ai-core-embedder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sap-ai-core-embedder.js","sourceRoot":"","sources":["../src/sap-ai-core-embedder.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AA6B5E,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAiB;IAEzC,YAAY,MAA+B;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,eAAe,CAAC;QACpD,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,GAAG,IAAI,6BAA6B,CAAC;gBAC/C,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAwB,CAAC;gBAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,OAAqB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU,CAAC,KAAe,EAAE,OAAqB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/service-key.d.ts

@@ -0,0 +1,10 @@
+export interface ParsedServiceKey {
+    clientId: string;
+    clientSecret: string;
+    /** Fully qualified token endpoint incl. `/oauth/token`. */
+    tokenUrl: string;
+    /** AI Core REST API base URL (no trailing slash). */
+    apiBaseUrl: string;
+}
+export declare function parseServiceKey(raw: string): ParsedServiceKey;
+//# sourceMappingURL=service-key.d.ts.map

package/dist/service-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-key.d.ts","sourceRoot":"","sources":["../src/service-key.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAgC7D"}

package/dist/service-key.js

@@ -0,0 +1,27 @@
+export function parseServiceKey(raw) {
+    let obj;
+    try {
+        obj = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`AICORE_SERVICE_KEY is not valid JSON: ${err.message}`);
+    }
+    const clientId = obj.clientid;
+    const clientSecret = obj.clientsecret;
+    const authUrl = obj.url;
+    const apiBaseUrl = obj.serviceurls?.AI_API_URL;
+    if (!clientId || !clientSecret || !authUrl || !apiBaseUrl) {
+        throw new Error('AICORE_SERVICE_KEY is missing required fields (clientid, clientsecret, url, serviceurls.AI_API_URL)');
+    }
+    const trimmedAuth = authUrl.replace(/\/+$/, '');
+    const tokenUrl = trimmedAuth.endsWith('/oauth/token')
+        ? trimmedAuth
+        : `${trimmedAuth}/oauth/token`;
+    return {
+        clientId,
+        clientSecret,
+        tokenUrl,
+        apiBaseUrl: apiBaseUrl.replace(/\/+$/, ''),
+    };
+}
+//# sourceMappingURL=service-key.js.map

package/dist/service-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-key.js","sourceRoot":"","sources":["../src/service-key.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,GAAkB,CAAC;IACvB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yCAA0C,GAAa,CAAC,OAAO,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC9B,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;IACxB,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC;IAE/C,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,qGAAqG,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC;QACnD,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,GAAG,WAAW,cAAc,CAAC;IAEjC,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,QAAQ;QACR,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/sap-aicore-embedder",
-  "version": "11.0.0",
+  "version": "11.1.0",
   "description": "SAP AI Core embedding provider (IEmbedder) for @mcp-abap-adt/llm-agent.",
   "type": "module",
   "main": "dist/index.js",