@endora-commerce/llm-client 0.0.0-stage → 0.107.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @endora-commerce/llm-client
+
+Provider-neutral LLM transport — fetch-based Anthropic, Google and OpenAI (and OpenAI-compatible) adapters with tool calling, shared by the modules that call a language model.
+
+## What this is
+
+A shared library package of **Endora Commerce**, the modular B2B/B2C commerce platform. It declares no module manifest, so the platform composes nothing from it: what is published here is what the platform and the modules built on it compile against.
+
+## Entry points
+
+- `@endora-commerce/llm-client`
+
+## Depends on
+
+**Bundled dependencies**
+
+- `@endora-commerce/contracts`
+- `zod` ^4.2.0
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+
+## Install
+
+```bash
+pnpm add @endora-commerce/llm-client
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/anthropic-adapter.d.ts

@@ -0,0 +1,9 @@
+import { type FetchLike, type LlmCompletion, type LlmProviderAdapter, type LlmRequest } from './provider.js';
+export declare class AnthropicAdapter implements LlmProviderAdapter {
+    private readonly apiKey;
+    private readonly fetchImpl;
+    readonly provider: "anthropic";
+    constructor(apiKey: string, fetchImpl?: FetchLike);
+    complete(req: LlmRequest): Promise<LlmCompletion>;
+}
+//# sourceMappingURL=anthropic-adapter.d.ts.map

package/dist/anthropic-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-adapter.d.ts","sourceRoot":"","sources":["../src/anthropic-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AAsBvB,qBAAa,gBAAiB,YAAW,kBAAkB;IAIvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,QAAQ,CAAC,QAAQ,EAAG,WAAW,CAAU;gBAGtB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAiB;IAGzC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CAmExD"}

package/dist/anthropic-adapter.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { fromWireName, parseOrThrow, postJson, toWireName, wireNameMap, } from './provider.js';
+/**
+ * Anthropic (Claude) adapter — `POST /v1/messages` with tool-use blocks.
+ * Native fetch, no SDK (research §R2).
+ */
+const ResponseSchema = z.object({
+    content: z.array(z.union([
+        z.object({ type: z.literal('text'), text: z.string() }),
+        z.object({
+            type: z.literal('tool_use'),
+            id: z.string(),
+            name: z.string(),
+            input: z.unknown(),
+        }),
+    ])),
+    stop_reason: z.string().nullable(),
+});
+export class AnthropicAdapter {
+    apiKey;
+    fetchImpl;
+    provider = 'anthropic';
+    constructor(apiKey, fetchImpl = fetch) {
+        this.apiKey = apiKey;
+        this.fetchImpl = fetchImpl;
+    }
+    async complete(req) {
+        const names = wireNameMap(req.tools);
+        const body = {
+            model: req.model,
+            max_tokens: req.maxTokens,
+            system: req.system,
+            tools: req.tools.map((t) => ({
+                name: toWireName(t.name),
+                description: t.description,
+                input_schema: t.inputSchema,
+            })),
+            ...(req.toolChoice ? { tool_choice: { type: 'tool', name: toWireName(req.toolChoice.name) } } : {}),
+            messages: req.messages.map((m) => {
+                if (m.role === 'user') {
+                    return { role: 'user', content: [{ type: 'text', text: m.text }] };
+                }
+                if (m.role === 'assistant') {
+                    return {
+                        role: 'assistant',
+                        content: [
+                            ...(m.text ? [{ type: 'text', text: m.text }] : []),
+                            ...m.toolCalls.map((c) => ({
+                                type: 'tool_use',
+                                id: c.id,
+                                name: toWireName(c.name),
+                                input: c.arguments,
+                            })),
+                        ],
+                    };
+                }
+                return {
+                    role: 'user',
+                    content: [
+                        { type: 'tool_result', tool_use_id: m.toolCallId, content: m.resultJson },
+                    ],
+                };
+            }),
+        };
+        const json = await postJson(this.provider, this.fetchImpl, 'https://api.anthropic.com/v1/messages', { 'x-api-key': this.apiKey, 'anthropic-version': '2023-06-01' }, body, req.signal);
+        const parsed = parseOrThrow(this.provider, ResponseSchema, json);
+        const textParts = parsed.content.filter((c) => c.type === 'text').map((c) => c.text);
+        const toolCalls = parsed.content
+            .filter((c) => c.type === 'tool_use')
+            .map((c) => ({ id: c.id, name: fromWireName(c.name, names), arguments: c.input }));
+        return {
+            text: textParts.length > 0 ? textParts.join('\n') : null,
+            toolCalls,
+            stopReason: parsed.stop_reason === 'tool_use'
+                ? 'tool_use'
+                : parsed.stop_reason === 'end_turn'
+                    ? 'end'
+                    : parsed.stop_reason === 'max_tokens'
+                        ? 'max_tokens'
+                        : 'other',
+        };
+    }
+}
+//# sourceMappingURL=anthropic-adapter.js.map

package/dist/anthropic-adapter.js.map

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

package/dist/create-llm-adapter.d.ts

@@ -0,0 +1,33 @@
+import type { FetchLike, LlmProvider, LlmProviderAdapter } from './provider.js';
+/**
+ * One factory for every consumer (feature 151, research R21): `prompt_actions`
+ * and `cms` resolve their own credential and hand the values in; which class
+ * speaks which protocol, and which endpoint a provider defaults to, is decided
+ * here once.
+ */
+/** Every provider code this package can call — `LlmProviderSchema`'s options. */
+export declare const LLM_PROVIDERS: readonly LlmProvider[];
+/** A configuration no call could succeed with; consumers report it as "not configured". */
+export declare class LlmConfigurationError extends Error {
+    readonly provider: LlmProvider;
+    readonly reason: 'base_url_required' | 'base_url_invalid';
+    readonly name = "LlmConfigurationError";
+    constructor(provider: LlmProvider, reason: 'base_url_required' | 'base_url_invalid');
+}
+/** The endpoint an OpenAI-protocol provider uses with no Base URL, or `null`. */
+export declare function defaultBaseUrlFor(provider: LlmProvider): string | null;
+/** `true` for an absolute `http:` / `https:` URL — the rule `credentials` applies on write too. */
+export declare function isHttpUrl(value: string): boolean;
+export interface CreateLlmAdapterOptions {
+    apiKey: string;
+    /** The credential's Base URL; blank or absent ⇒ the provider default. Ignored by anthropic/google. */
+    baseUrl?: string | null | undefined;
+    fetchImpl?: FetchLike | undefined;
+}
+/**
+ * Build the adapter for `provider`. Throws `LlmConfigurationError` synchronously
+ * for an `openai_compatible` configuration without a Base URL and for a Base URL
+ * that is not an absolute http(s) URL, so the caller learns it before any call.
+ */
+export declare function createLlmAdapter(provider: LlmProvider, options: CreateLlmAdapterOptions): LlmProviderAdapter;
+//# sourceMappingURL=create-llm-adapter.d.ts.map

package/dist/create-llm-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-llm-adapter.d.ts","sourceRoot":"","sources":["../src/create-llm-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhF;;;;;GAKG;AAEH,iFAAiF;AACjF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA8B,CAAC;AAE/E,2FAA2F;AAC3F,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,QAAQ,EAAE,WAAW;aACrB,MAAM,EAAE,mBAAmB,GAAG,kBAAkB;IAHlE,SAAkB,IAAI,2BAA2B;gBAE/B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,mBAAmB,GAAG,kBAAkB;CAQnE;AAOD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,uBAAuB,GAC/B,kBAAkB,CAiBpB"}

package/dist/create-llm-adapter.js

@@ -0,0 +1,69 @@
+import { LlmProviderSchema } from '@endora-commerce/contracts';
+import { AnthropicAdapter } from './anthropic-adapter.js';
+import { GoogleAdapter } from './google-adapter.js';
+import { OpenAiAdapter } from './openai-adapter.js';
+/**
+ * One factory for every consumer (feature 151, research R21): `prompt_actions`
+ * and `cms` resolve their own credential and hand the values in; which class
+ * speaks which protocol, and which endpoint a provider defaults to, is decided
+ * here once.
+ */
+/** Every provider code this package can call — `LlmProviderSchema`'s options. */
+export const LLM_PROVIDERS = LlmProviderSchema.options;
+/** A configuration no call could succeed with; consumers report it as "not configured". */
+export class LlmConfigurationError extends Error {
+    provider;
+    reason;
+    name = 'LlmConfigurationError';
+    constructor(provider, reason) {
+        super(reason === 'base_url_required'
+            ? `The ${provider} provider needs a Base URL.`
+            : `The ${provider} Base URL must be an absolute http or https URL.`);
+        this.provider = provider;
+        this.reason = reason;
+    }
+}
+const DEFAULT_BASE_URLS = {
+    openai: 'https://api.openai.com/v1',
+    deepseek: 'https://api.deepseek.com',
+};
+/** The endpoint an OpenAI-protocol provider uses with no Base URL, or `null`. */
+export function defaultBaseUrlFor(provider) {
+    return DEFAULT_BASE_URLS[provider] ?? null;
+}
+/** `true` for an absolute `http:` / `https:` URL — the rule `credentials` applies on write too. */
+export function isHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:' || url.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build the adapter for `provider`. Throws `LlmConfigurationError` synchronously
+ * for an `openai_compatible` configuration without a Base URL and for a Base URL
+ * that is not an absolute http(s) URL, so the caller learns it before any call.
+ */
+export function createLlmAdapter(provider, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    if (provider === 'anthropic')
+        return new AnthropicAdapter(options.apiKey, fetchImpl);
+    if (provider === 'google')
+        return new GoogleAdapter(options.apiKey, fetchImpl);
+    const configured = options.baseUrl?.trim() ?? '';
+    if (configured !== '' && !isHttpUrl(configured)) {
+        throw new LlmConfigurationError(provider, 'base_url_invalid');
+    }
+    const baseUrl = configured !== '' ? configured : defaultBaseUrlFor(provider);
+    if (baseUrl === null)
+        throw new LlmConfigurationError(provider, 'base_url_required');
+    // `openai` with no Base URL passes none, so its endpoint is the adapter's own
+    // default and the request stays what it was before this factory existed.
+    return new OpenAiAdapter(options.apiKey, fetchImpl, {
+        provider,
+        ...(provider === 'openai' && configured === '' ? {} : { baseUrl }),
+    });
+}
+//# sourceMappingURL=create-llm-adapter.js.map

package/dist/create-llm-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-llm-adapter.js","sourceRoot":"","sources":["../src/create-llm-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;;GAKG;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAA2B,iBAAiB,CAAC,OAAO,CAAC;AAE/E,2FAA2F;AAC3F,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAG5B;IACA;IAHA,IAAI,GAAG,uBAAuB,CAAC;IACjD,YACkB,QAAqB,EACrB,MAAgD;QAEhE,KAAK,CACH,MAAM,KAAK,mBAAmB;YAC5B,CAAC,CAAC,OAAO,QAAQ,6BAA6B;YAC9C,CAAC,CAAC,OAAO,QAAQ,kDAAkD,CACtE,CAAC;QAPc,aAAQ,GAAR,QAAQ,CAAa;QACrB,WAAM,GAAN,MAAM,CAA0C;IAOlE,CAAC;CACF;AAED,MAAM,iBAAiB,GAAyC;IAC9D,MAAM,EAAE,2BAA2B;IACnC,QAAQ,EAAE,0BAA0B;CACrC,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAqB,EACrB,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,IAAI,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrF,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE/E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,UAAU,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7E,IAAI,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACrF,8EAA8E;IAC9E,yEAAyE;IACzE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE;QAClD,QAAQ;QACR,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KACnE,CAAC,CAAC;AACL,CAAC"}

package/dist/google-adapter.d.ts

@@ -0,0 +1,9 @@
+import { type FetchLike, type LlmCompletion, type LlmProviderAdapter, type LlmRequest } from './provider.js';
+export declare class GoogleAdapter implements LlmProviderAdapter {
+    private readonly apiKey;
+    private readonly fetchImpl;
+    readonly provider: "google";
+    constructor(apiKey: string, fetchImpl?: FetchLike);
+    complete(req: LlmRequest): Promise<LlmCompletion>;
+}
+//# sourceMappingURL=google-adapter.d.ts.map

package/dist/google-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-adapter.d.ts","sourceRoot":"","sources":["../src/google-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AA4CvB,qBAAa,aAAc,YAAW,kBAAkB;IAIpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;gBAGnB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAiB;IAGzC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CA+FxD"}

package/dist/google-adapter.js

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+import { fromWireName, parseOrThrow, postJson, toWireName, wireNameMap, } from './provider.js';
+/**
+ * Google (Gemini) adapter — `POST :generateContent` with
+ * functionDeclarations / functionCall parts. Native fetch, no SDK
+ * (research §R2). Gemini returns no tool-call ids, so synthetic ids are
+ * minted per response; functionResponse parts are matched by name, which the
+ * API expects.
+ */
+const ResponseSchema = z.object({
+    candidates: z
+        .array(z.object({
+        content: z.object({
+            parts: z
+                .array(z.union([
+                z.object({ text: z.string() }),
+                z.object({
+                    functionCall: z.object({ name: z.string(), args: z.unknown().optional() }),
+                }),
+            ]))
+                .default([]),
+        }),
+        finishReason: z.string().optional(),
+    }))
+        .min(1),
+});
+/** Gemini's parameter schema is an OpenAPI subset — strip JSON-Schema-only keys. */
+function sanitizeForGemini(schema) {
+    if (Array.isArray(schema))
+        return schema.map(sanitizeForGemini);
+    if (typeof schema !== 'object' || schema === null)
+        return schema;
+    const out = {};
+    for (const [k, v] of Object.entries(schema)) {
+        if (k === '$schema' || k === 'additionalProperties')
+            continue;
+        out[k] = sanitizeForGemini(v);
+    }
+    return out;
+}
+export class GoogleAdapter {
+    apiKey;
+    fetchImpl;
+    provider = 'google';
+    constructor(apiKey, fetchImpl = fetch) {
+        this.apiKey = apiKey;
+        this.fetchImpl = fetchImpl;
+    }
+    async complete(req) {
+        const names = wireNameMap(req.tools);
+        const body = {
+            systemInstruction: { parts: [{ text: req.system }] },
+            generationConfig: { maxOutputTokens: req.maxTokens },
+            tools: [
+                {
+                    functionDeclarations: req.tools.map((t) => ({
+                        name: toWireName(t.name),
+                        description: t.description,
+                        parameters: sanitizeForGemini(t.inputSchema),
+                    })),
+                },
+            ],
+            ...(req.toolChoice
+                ? {
+                    toolConfig: {
+                        functionCallingConfig: {
+                            mode: 'ANY',
+                            allowedFunctionNames: [toWireName(req.toolChoice.name)],
+                        },
+                    },
+                }
+                : {}),
+            contents: req.messages.map((m) => {
+                if (m.role === 'user')
+                    return { role: 'user', parts: [{ text: m.text }] };
+                if (m.role === 'assistant') {
+                    return {
+                        role: 'model',
+                        parts: [
+                            ...(m.text ? [{ text: m.text }] : []),
+                            ...m.toolCalls.map((c) => ({
+                                functionCall: { name: toWireName(c.name), args: c.arguments ?? {} },
+                            })),
+                        ],
+                    };
+                }
+                let response;
+                try {
+                    response = JSON.parse(m.resultJson);
+                }
+                catch {
+                    response = { value: m.resultJson };
+                }
+                // functionResponse.response must be an object.
+                const wrapped = typeof response === 'object' && response !== null && !Array.isArray(response)
+                    ? response
+                    : { value: response };
+                return {
+                    role: 'user',
+                    parts: [
+                        { functionResponse: { name: toWireName(m.toolName), response: wrapped } },
+                    ],
+                };
+            }),
+        };
+        const json = await postJson(this.provider, this.fetchImpl, `https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(req.model)}:generateContent`, { 'x-goog-api-key': this.apiKey }, body, req.signal);
+        const parsed = parseOrThrow(this.provider, ResponseSchema, json);
+        const candidate = parsed.candidates[0];
+        const texts = [];
+        const toolCalls = [];
+        candidate.content.parts.forEach((part, index) => {
+            if ('text' in part) {
+                texts.push(part.text);
+                return;
+            }
+            toolCalls.push({
+                id: `gcall_${index}_${part.functionCall.name}`,
+                name: fromWireName(part.functionCall.name, names),
+                arguments: part.functionCall.args ?? {},
+            });
+        });
+        return {
+            text: texts.length > 0 ? texts.join('\n') : null,
+            toolCalls,
+            stopReason: toolCalls.length > 0
+                ? 'tool_use'
+                : candidate.finishReason === 'STOP'
+                    ? 'end'
+                    : candidate.finishReason === 'MAX_TOKENS'
+                        ? 'max_tokens'
+                        : 'other',
+        };
+    }
+}
+//# sourceMappingURL=google-adapter.js.map

package/dist/google-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-adapter.js","sourceRoot":"","sources":["../src/google-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,WAAW,GAKZ,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,UAAU,EAAE,CAAC;SACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,KAAK,EAAE,CAAC;iBACL,KAAK,CACJ,CAAC,CAAC,KAAK,CAAC;gBACN,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC9B,CAAC,CAAC,MAAM,CAAC;oBACP,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;iBAC3E,CAAC;aACH,CAAC,CACH;iBACA,OAAO,CAAC,EAAE,CAAC;SACf,CAAC;QACF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;CACV,CAAC,CAAC;AAEH,oFAAoF;AACpF,SAAS,iBAAiB,CAAC,MAAe;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAChE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACjE,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,sBAAsB;YAAE,SAAS;QAC9D,GAAG,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,OAAO,aAAa;IAIL;IACA;IAJV,QAAQ,GAAG,QAAiB,CAAC;IAEtC,YACmB,MAAc,EACd,YAAuB,KAAK;QAD5B,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAmB;IAC5C,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,GAAe;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG;YACX,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;YACpD,gBAAgB,EAAE,EAAE,eAAe,EAAE,GAAG,CAAC,SAAS,EAAE;YACpD,KAAK,EAAE;gBACL;oBACE,oBAAoB,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC1C,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;wBACxB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC;qBAC7C,CAAC,CAAC;iBACJ;aACF;YACD,GAAG,CAAC,GAAG,CAAC,UAAU;gBAChB,CAAC,CAAC;oBACE,UAAU,EAAE;wBACV,qBAAqB,EAAE;4BACrB,IAAI,EAAE,KAAK;4BACX,oBAAoB,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;yBACxD;qBACF;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/B,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC1E,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAC3B,OAAO;wBACL,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;4BACrC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCACzB,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE;6BACpE,CAAC,CAAC;yBACJ;qBACF,CAAC;gBACJ,CAAC;gBACD,IAAI,QAAiB,CAAC;gBACtB,IAAI,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBACtC,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;gBACrC,CAAC;gBACD,+CAA+C;gBAC/C,MAAM,OAAO,GACX,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAC3E,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAC1B,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE;wBACL,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;qBAC1E;iBACF,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,EACd,2DAA2D,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAC1G,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE,EACjC,IAAI,EACJ,GAAG,CAAC,MAAM,CACX,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;QAExC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,SAAS,GAA+B,EAAE,CAAC;QACjD,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC9C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,SAAS,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;gBAC9C,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;gBACjD,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE;aACxC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;YAChD,SAAS;YACT,UAAU,EACR,SAAS,CAAC,MAAM,GAAG,CAAC;gBAClB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,SAAS,CAAC,YAAY,KAAK,MAAM;oBACjC,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,SAAS,CAAC,YAAY,KAAK,YAAY;wBACvC,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,OAAO;SAClB,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@endora-commerce/llm-client` — the platform's provider-neutral LLM transport
+ * (feature 151, research R2).
+ *
+ * Moved unchanged from `prompt_actions` so that a second module (the Page
+ * Builder translation in `cms`) can call the same three provider protocols
+ * without a module edge. Stateless: no settings, no credentials, no logging —
+ * each consumer resolves its own credential and passes the key in.
+ */
+export { LlmProviderError, fromWireName, toWireName, wireNameMap, type FetchLike, type LlmCompletion, type LlmMessage, type LlmProvider, type LlmProviderAdapter, type LlmRequest, type LlmToolCall, type LlmToolDefinition, } from './provider.js';
+export { AnthropicAdapter } from './anthropic-adapter.js';
+export { GoogleAdapter } from './google-adapter.js';
+export { OpenAiAdapter } from './openai-adapter.js';
+export type { OpenAiAdapterOptions, OpenAiProtocolProvider } from './openai-adapter.js';
+export { LLM_PROVIDERS, LlmConfigurationError, createLlmAdapter, defaultBaseUrlFor, isHttpUrl, type CreateLlmAdapterOptions, } from './create-llm-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@endora-commerce/llm-client` — the platform's provider-neutral LLM transport
+ * (feature 151, research R2).
+ *
+ * Moved unchanged from `prompt_actions` so that a second module (the Page
+ * Builder translation in `cms`) can call the same three provider protocols
+ * without a module edge. Stateless: no settings, no credentials, no logging —
+ * each consumer resolves its own credential and passes the key in.
+ */
+export { LlmProviderError, fromWireName, toWireName, wireNameMap, } from './provider.js';
+export { AnthropicAdapter } from './anthropic-adapter.js';
+export { GoogleAdapter } from './google-adapter.js';
+export { OpenAiAdapter } from './openai-adapter.js';
+export { LLM_PROVIDERS, LlmConfigurationError, createLlmAdapter, defaultBaseUrlFor, isHttpUrl, } from './create-llm-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,WAAW,GASZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GAEV,MAAM,yBAAyB,CAAC"}

package/dist/openai-adapter.d.ts

@@ -0,0 +1,21 @@
+import { type FetchLike, type LlmCompletion, type LlmProviderAdapter, type LlmRequest } from './provider.js';
+/** The providers that speak this protocol (feature 151, research R21). */
+export type OpenAiProtocolProvider = 'openai' | 'deepseek' | 'openai_compatible';
+export interface OpenAiAdapterOptions {
+    /** Whose endpoint this is; named in errors and `provider`. Default `openai`. */
+    provider?: OpenAiProtocolProvider | undefined;
+    /**
+     * The API root the request is posted under, as `<baseUrl>/chat/completions`.
+     * Default: OpenAI's public endpoint. Validated by `createLlmAdapter`, not here.
+     */
+    baseUrl?: string | undefined;
+}
+export declare class OpenAiAdapter implements LlmProviderAdapter {
+    private readonly apiKey;
+    private readonly fetchImpl;
+    readonly provider: OpenAiProtocolProvider;
+    private readonly endpoint;
+    constructor(apiKey: string, fetchImpl?: FetchLike, options?: OpenAiAdapterOptions);
+    complete(req: LlmRequest): Promise<LlmCompletion>;
+}
+//# sourceMappingURL=openai-adapter.d.ts.map

package/dist/openai-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-adapter.d.ts","sourceRoot":"","sources":["../src/openai-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AA8BvB,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAID,qBAAa,aAAc,YAAW,kBAAkB;IAKpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAiB,EAC7C,OAAO,GAAE,oBAAyB;IAM9B,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CAkFxD"}

package/dist/openai-adapter.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { LlmProviderError, fromWireName, parseOrThrow, postJson, toWireName, wireNameMap, } from './provider.js';
+/**
+ * OpenAI (GPT) adapter — `POST /v1/chat/completions` with tools/tool_calls.
+ * Native fetch, no SDK (research §R2). Tool-call arguments arrive as a JSON
+ * string and are parsed here; the interpreter re-validates against the
+ * tool's Zod schema regardless.
+ */
+const ResponseSchema = z.object({
+    choices: z
+        .array(z.object({
+        message: z.object({
+            content: z.string().nullable().optional(),
+            tool_calls: z
+                .array(z.object({
+                id: z.string(),
+                function: z.object({ name: z.string(), arguments: z.string() }),
+            }))
+                .optional(),
+        }),
+        finish_reason: z.string().nullable().optional(),
+    }))
+        .min(1),
+});
+const OPENAI_BASE_URL = 'https://api.openai.com/v1';
+export class OpenAiAdapter {
+    apiKey;
+    fetchImpl;
+    provider;
+    endpoint;
+    constructor(apiKey, fetchImpl = fetch, options = {}) {
+        this.apiKey = apiKey;
+        this.fetchImpl = fetchImpl;
+        this.provider = options.provider ?? 'openai';
+        this.endpoint = `${(options.baseUrl ?? OPENAI_BASE_URL).replace(/\/+$/, '')}/chat/completions`;
+    }
+    async complete(req) {
+        const names = wireNameMap(req.tools);
+        const body = {
+            model: req.model,
+            // OpenAI renamed the cap; DeepSeek and the compatible servers (vLLM,
+            // Ollama, OpenRouter, …) take the original name. `openai` keeps the
+            // field it has always sent.
+            ...(this.provider === 'openai'
+                ? { max_completion_tokens: req.maxTokens }
+                : { max_tokens: req.maxTokens }),
+            messages: [
+                { role: 'system', content: req.system },
+                ...req.messages.map((m) => {
+                    if (m.role === 'user')
+                        return { role: 'user', content: m.text };
+                    if (m.role === 'assistant') {
+                        return {
+                            role: 'assistant',
+                            content: m.text,
+                            ...(m.toolCalls.length > 0
+                                ? {
+                                    tool_calls: m.toolCalls.map((c) => ({
+                                        id: c.id,
+                                        type: 'function',
+                                        function: {
+                                            name: toWireName(c.name),
+                                            arguments: JSON.stringify(c.arguments),
+                                        },
+                                    })),
+                                }
+                                : {}),
+                        };
+                    }
+                    return { role: 'tool', tool_call_id: m.toolCallId, content: m.resultJson };
+                }),
+            ],
+            tools: req.tools.map((t) => ({
+                type: 'function',
+                function: { name: toWireName(t.name), description: t.description, parameters: t.inputSchema },
+            })),
+            ...(req.toolChoice
+                ? { tool_choice: { type: 'function', function: { name: toWireName(req.toolChoice.name) } } }
+                : {}),
+        };
+        const json = await postJson(this.provider, this.fetchImpl, this.endpoint, { authorization: `Bearer ${this.apiKey}` }, body, req.signal);
+        const parsed = parseOrThrow(this.provider, ResponseSchema, json);
+        const choice = parsed.choices[0];
+        const toolCalls = (choice.message.tool_calls ?? []).map((c) => {
+            let args;
+            try {
+                args = JSON.parse(c.function.arguments);
+            }
+            catch {
+                throw new LlmProviderError(this.provider, 'malformed', `${this.provider} tool call "${c.function.name}" carried non-JSON arguments.`);
+            }
+            return { id: c.id, name: fromWireName(c.function.name, names), arguments: args };
+        });
+        return {
+            text: choice.message.content ?? null,
+            toolCalls,
+            stopReason: choice.finish_reason === 'tool_calls'
+                ? 'tool_use'
+                : choice.finish_reason === 'stop'
+                    ? 'end'
+                    : choice.finish_reason === 'length'
+                        ? 'max_tokens'
+                        : 'other',
+        };
+    }
+}
+//# sourceMappingURL=openai-adapter.js.map

package/dist/openai-adapter.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,78 @@
+import type { z } from 'zod';
+import type { LlmProvider, LlmToolDefinition } from '@endora-commerce/contracts';
+/**
+ * Provider-neutral LLM adapter contract (feature 043, research §R2).
+ *
+ * Three thin adapters (Anthropic / Google / OpenAI) speak the providers'
+ * native tool-calling REST APIs over injected `fetch` — no SDK dependency.
+ * Everything the interpreter consumes is normalized to this shape; provider
+ * responses are Zod-validated at the boundary (Principle V).
+ */
+export type { LlmProvider, LlmToolDefinition };
+export type LlmMessage = {
+    role: 'user';
+    text: string;
+} | {
+    role: 'assistant';
+    text: string | null;
+    toolCalls: LlmToolCall[];
+} | {
+    role: 'tool_result';
+    toolCallId: string;
+    toolName: string;
+    resultJson: string;
+};
+export interface LlmToolCall {
+    id: string;
+    /** Dotted registry id, e.g. 'inventory.set_stock_level'. */
+    name: string;
+    arguments: unknown;
+}
+export interface LlmRequest {
+    model: string;
+    system: string;
+    messages: LlmMessage[];
+    tools: LlmToolDefinition[];
+    maxTokens: number;
+    /**
+     * Feature 151 (research R3) — forces the model to answer by calling this
+     * tool, mapped to each provider's native option. Absent ⇒ the provider's
+     * default (the model chooses), and the request body is exactly what it was
+     * before the option existed.
+     */
+    toolChoice?: {
+        name: string;
+    };
+    /** Feature 151 — passed to `fetch`, so a caller can impose a timeout or cancel. */
+    signal?: AbortSignal;
+}
+export interface LlmCompletion {
+    text: string | null;
+    toolCalls: LlmToolCall[];
+    stopReason: 'tool_use' | 'end' | 'max_tokens' | 'other';
+}
+export interface LlmProviderAdapter {
+    readonly provider: LlmProvider;
+    complete(req: LlmRequest): Promise<LlmCompletion>;
+}
+export declare class LlmProviderError extends Error {
+    readonly provider: LlmProvider;
+    readonly kind: 'http' | 'network' | 'malformed';
+    readonly status?: number | undefined;
+    /** Feature 151 — `true` when a `network` failure was the request's `AbortSignal` firing. */
+    readonly aborted: boolean;
+    readonly name = "LlmProviderError";
+    constructor(provider: LlmProvider, kind: 'http' | 'network' | 'malformed', message: string, status?: number | undefined, 
+    /** Feature 151 — `true` when a `network` failure was the request's `AbortSignal` firing. */
+    aborted?: boolean);
+}
+export type FetchLike = typeof fetch;
+export declare function toWireName(id: string): string;
+export declare function wireNameMap(tools: LlmToolDefinition[]): Map<string, string>;
+export declare function fromWireName(wire: string, map: Map<string, string>): string;
+/** Shared POST + JSON helper with uniform error mapping. */
+export declare function postJson(provider: LlmProvider, fetchImpl: FetchLike, url: string, headers: Record<string, string>, body: unknown, signal?: AbortSignal): Promise<unknown>;
+export declare function malformed(provider: LlmProvider, issues: unknown): LlmProviderError;
+/** Boundary guard reused by adapters. */
+export declare function parseOrThrow<T>(provider: LlmProvider, schema: z.ZodType<T>, value: unknown): T;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

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

package/dist/provider.js

@@ -0,0 +1,73 @@
+export class LlmProviderError extends Error {
+    provider;
+    kind;
+    status;
+    aborted;
+    name = 'LlmProviderError';
+    constructor(provider, kind, message, status, 
+    /** Feature 151 — `true` when a `network` failure was the request's `AbortSignal` firing. */
+    aborted = false) {
+        super(message);
+        this.provider = provider;
+        this.kind = kind;
+        this.status = status;
+        this.aborted = aborted;
+    }
+}
+// ---------------------------------------------------------------------------
+// Wire-name sanitization
+// ---------------------------------------------------------------------------
+// Registry ids are dotted ('catalog.search_products') but Anthropic and
+// OpenAI tool names must match ^[a-zA-Z0-9_-]{1,64}$. All adapters therefore
+// send '__'-joined names and translate responses back through a per-request
+// reverse map (never string surgery — ids may legitimately contain '_').
+export function toWireName(id) {
+    return id.replace(/\./g, '__');
+}
+export function wireNameMap(tools) {
+    return new Map(tools.map((t) => [toWireName(t.name), t.name]));
+}
+export function fromWireName(wire, map) {
+    return map.get(wire) ?? wire;
+}
+/** Shared POST + JSON helper with uniform error mapping. */
+export async function postJson(provider, fetchImpl, url, headers, body, signal) {
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', ...headers },
+            body: JSON.stringify(body),
+            // Only when given, so a request without one is the same `init` as before.
+            ...(signal ? { signal } : {}),
+        });
+    }
+    catch (err) {
+        throw new LlmProviderError(provider, 'network', `Could not reach the ${provider} API: ${err.message}`, undefined, signal?.aborted === true);
+    }
+    let json = null;
+    try {
+        json = await response.json();
+    }
+    catch {
+        // fall through — handled below
+    }
+    if (!response.ok) {
+        throw new LlmProviderError(provider, 'http', `${provider} API responded with HTTP ${response.status}.`, response.status);
+    }
+    if (json === null) {
+        throw new LlmProviderError(provider, 'malformed', `${provider} API returned a non-JSON body.`);
+    }
+    return json;
+}
+export function malformed(provider, issues) {
+    return new LlmProviderError(provider, 'malformed', `${provider} API response did not match the expected shape: ${JSON.stringify(issues).slice(0, 500)}`);
+}
+/** Boundary guard reused by adapters. */
+export function parseOrThrow(provider, schema, value) {
+    const r = schema.safeParse(value);
+    if (!r.success)
+        throw malformed(provider, r.error.issues);
+    return r.data;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@endora-commerce/llm-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.107.0",
+  "type": "module",
+  "description": "Provider-neutral LLM transport — fetch-based Anthropic, Google and OpenAI (and OpenAI-compatible) adapters with tool calling, shared by the modules that call a language model.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/llm-client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "dependencies": {
+    "zod": "^4.2.0",
+    "@endora-commerce/contracts": "0.107.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
 }