@charivo/llm 0.10.7 → 0.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -161,6 +161,12 @@ modalities can reuse.
161
161
  history, not rotate a pinned gateway session, so a client-side `sessionKey`
162
162
  would silently replay the old transcript after a reset. Server routes that
163
163
  construct the provider directly can rotate `sessionKey` themselves.
164
+ - `@charivo/llm/gemini`: `createGeminiLLMClient(config)` (browser client,
165
+ dev/testing only) and, for server-side use, `createGeminiLLMProvider(config)`,
166
+ `GeminiLLMProvider`, `type GeminiLLMConfig`. Tool-call history is resent with
167
+ Gemini's documented `skip_thought_signature_validator` placeholder because
168
+ `LLMToolCall` carries no thought signature, so reasoning continuity across
169
+ tool rounds is lost.
164
170
 
165
171
  ## Manager API
166
172
 
@@ -0,0 +1,35 @@
1
+ import { LLMProvider, LLMMessage, ToolDefinition, LLMToolResponse, LLMClient } from '@charivo/core';
2
+
3
+ interface GeminiLLMConfig {
4
+ apiKey: string;
5
+ model?: string;
6
+ temperature?: number;
7
+ maxTokens?: number;
8
+ dangerouslyAllowBrowser?: boolean;
9
+ }
10
+ /**
11
+ * Gemini 3 answers HTTP 400 ("Function call is missing a thought_signature in
12
+ * functionCall parts") when a resent assistant `tool_calls` turn lacks the
13
+ * `thought_signature` Gemini attached to its first call. `LLMToolCall` has no
14
+ * field for the real signature Gemini returned, so this provider sends a
15
+ * documented skip placeholder instead and loses reasoning continuity across
16
+ * tool rounds.
17
+ */
18
+ declare class GeminiLLMProvider implements LLMProvider {
19
+ private openai;
20
+ private model;
21
+ private temperature?;
22
+ private maxTokens;
23
+ constructor(config: GeminiLLMConfig);
24
+ generateResponse(messages: Array<{
25
+ role: string;
26
+ content: string;
27
+ }>): Promise<string>;
28
+ generateResponseWithTools(messages: LLMMessage[], tools: ToolDefinition[]): Promise<LLMToolResponse>;
29
+ }
30
+ declare function createGeminiLLMProvider(config: GeminiLLMConfig): GeminiLLMProvider;
31
+
32
+ type GeminiLLMClientConfig = GeminiLLMConfig;
33
+ declare function createGeminiLLMClient(config: GeminiLLMClientConfig): LLMClient;
34
+
35
+ export { type GeminiLLMClientConfig, type GeminiLLMConfig, GeminiLLMProvider, createGeminiLLMClient, createGeminiLLMProvider };
@@ -0,0 +1,35 @@
1
+ import { LLMProvider, LLMMessage, ToolDefinition, LLMToolResponse, LLMClient } from '@charivo/core';
2
+
3
+ interface GeminiLLMConfig {
4
+ apiKey: string;
5
+ model?: string;
6
+ temperature?: number;
7
+ maxTokens?: number;
8
+ dangerouslyAllowBrowser?: boolean;
9
+ }
10
+ /**
11
+ * Gemini 3 answers HTTP 400 ("Function call is missing a thought_signature in
12
+ * functionCall parts") when a resent assistant `tool_calls` turn lacks the
13
+ * `thought_signature` Gemini attached to its first call. `LLMToolCall` has no
14
+ * field for the real signature Gemini returned, so this provider sends a
15
+ * documented skip placeholder instead and loses reasoning continuity across
16
+ * tool rounds.
17
+ */
18
+ declare class GeminiLLMProvider implements LLMProvider {
19
+ private openai;
20
+ private model;
21
+ private temperature?;
22
+ private maxTokens;
23
+ constructor(config: GeminiLLMConfig);
24
+ generateResponse(messages: Array<{
25
+ role: string;
26
+ content: string;
27
+ }>): Promise<string>;
28
+ generateResponseWithTools(messages: LLMMessage[], tools: ToolDefinition[]): Promise<LLMToolResponse>;
29
+ }
30
+ declare function createGeminiLLMProvider(config: GeminiLLMConfig): GeminiLLMProvider;
31
+
32
+ type GeminiLLMClientConfig = GeminiLLMConfig;
33
+ declare function createGeminiLLMClient(config: GeminiLLMClientConfig): LLMClient;
34
+
35
+ export { type GeminiLLMClientConfig, type GeminiLLMConfig, GeminiLLMProvider, createGeminiLLMClient, createGeminiLLMProvider };
@@ -0,0 +1,246 @@
1
+ 'use strict';
2
+
3
+ var OpenAI = require('openai');
4
+ var core = require('@charivo/core');
5
+
6
+ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
7
+
8
+ var OpenAI__default = /*#__PURE__*/_interopDefault(OpenAI);
9
+
10
+ // src/gemini/provider.ts
11
+ function toOpenAIChatMessages(messages) {
12
+ return messages.map((message) => {
13
+ switch (message.role) {
14
+ case "tool":
15
+ return {
16
+ role: "tool",
17
+ tool_call_id: message.toolCallId,
18
+ content: message.content
19
+ };
20
+ case "assistant":
21
+ return {
22
+ role: "assistant",
23
+ content: message.content,
24
+ ...message.toolCalls && message.toolCalls.length > 0 ? { tool_calls: message.toolCalls.map(toOpenAIToolCall) } : {}
25
+ };
26
+ case "system":
27
+ case "user":
28
+ return { role: message.role, content: message.content };
29
+ }
30
+ });
31
+ }
32
+ function toOpenAITools(tools) {
33
+ if (tools.length === 0) {
34
+ return void 0;
35
+ }
36
+ return tools.map((tool) => ({
37
+ type: "function",
38
+ function: {
39
+ name: tool.name,
40
+ description: tool.description,
41
+ parameters: tool.parameters
42
+ }
43
+ }));
44
+ }
45
+ function toLLMToolResponse(message) {
46
+ const toolCalls = readToolCalls(message);
47
+ return {
48
+ content: message?.content ?? "",
49
+ ...toolCalls.length > 0 ? { toolCalls } : {}
50
+ };
51
+ }
52
+ function readToolCalls(message) {
53
+ const rawToolCalls = message?.tool_calls;
54
+ if (!rawToolCalls || rawToolCalls.length === 0) {
55
+ return [];
56
+ }
57
+ return rawToolCalls.map(toLLMToolCall);
58
+ }
59
+ function toOpenAIToolCall(toolCall) {
60
+ return {
61
+ id: toolCall.id,
62
+ type: "function",
63
+ function: {
64
+ name: toolCall.name,
65
+ arguments: JSON.stringify(toolCall.arguments)
66
+ }
67
+ };
68
+ }
69
+ function toLLMToolCall(raw) {
70
+ if (!isPlainObject(raw)) {
71
+ throw new core.CharivoProviderError("LLM tool call must be an object");
72
+ }
73
+ const id = raw.id;
74
+ if (typeof id !== "string" || id.length === 0) {
75
+ throw new core.CharivoProviderError(
76
+ 'LLM tool call is missing a non-empty string "id"'
77
+ );
78
+ }
79
+ const name = raw.function?.name;
80
+ if (typeof name !== "string" || name.length === 0) {
81
+ throw new core.CharivoProviderError(
82
+ `LLM tool call "${id}" is missing a non-empty string "function.name"`
83
+ );
84
+ }
85
+ return {
86
+ id,
87
+ name,
88
+ arguments: parseToolArguments(name, raw.function.arguments)
89
+ };
90
+ }
91
+ function parseToolArguments(name, rawArguments) {
92
+ let parsed;
93
+ try {
94
+ parsed = JSON.parse(rawArguments);
95
+ } catch (error) {
96
+ throw new core.CharivoProviderError(
97
+ `LLM tool call "${name}" has unparsable "function.arguments"`,
98
+ { cause: error instanceof Error ? error : void 0 }
99
+ );
100
+ }
101
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
102
+ throw new core.CharivoProviderError(
103
+ `LLM tool call "${name}" has "function.arguments" that are not a JSON object`
104
+ );
105
+ }
106
+ return parsed;
107
+ }
108
+ function isPlainObject(value) {
109
+ return typeof value === "object" && value !== null && !Array.isArray(value);
110
+ }
111
+
112
+ // src/gemini/provider.ts
113
+ var GEMINI_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai/";
114
+ var DEFAULT_MODEL = "gemini-3.5-flash-lite";
115
+ var REQUEST_TIMEOUT_MS = 3e4;
116
+ var THOUGHT_SIGNATURE_SKIP = "skip_thought_signature_validator";
117
+ var GeminiLLMProvider = class {
118
+ openai;
119
+ model;
120
+ temperature;
121
+ maxTokens;
122
+ constructor(config) {
123
+ if (typeof window !== "undefined" && !config.dangerouslyAllowBrowser) {
124
+ throw new core.CharivoStateError(
125
+ "Gemini LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing"
126
+ );
127
+ }
128
+ this.openai = new OpenAI__default.default({
129
+ apiKey: config.apiKey,
130
+ baseURL: GEMINI_BASE_URL,
131
+ dangerouslyAllowBrowser: config.dangerouslyAllowBrowser
132
+ });
133
+ this.model = config.model || DEFAULT_MODEL;
134
+ this.temperature = config.temperature;
135
+ this.maxTokens = config.maxTokens || 1e3;
136
+ }
137
+ async generateResponse(messages) {
138
+ try {
139
+ const openAIMessages = messages.map((msg) => ({
140
+ role: msg.role,
141
+ content: msg.content
142
+ }));
143
+ const completion = await withTimeout(
144
+ (signal) => this.openai.chat.completions.create(
145
+ {
146
+ model: this.model,
147
+ messages: openAIMessages,
148
+ ...this.temperature !== void 0 ? { temperature: this.temperature } : {},
149
+ max_tokens: this.maxTokens
150
+ },
151
+ { signal }
152
+ ),
153
+ `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
154
+ );
155
+ return completion.choices[0]?.message?.content || "";
156
+ } catch (error) {
157
+ throw core.toCharivoError("provider", error, "Gemini LLM request failed");
158
+ }
159
+ }
160
+ async generateResponseWithTools(messages, tools) {
161
+ try {
162
+ const openAITools = toOpenAITools(tools);
163
+ const completion = await withTimeout(
164
+ (signal) => this.openai.chat.completions.create(
165
+ {
166
+ model: this.model,
167
+ messages: toGeminiChatMessages(messages),
168
+ ...this.temperature !== void 0 ? { temperature: this.temperature } : {},
169
+ max_tokens: this.maxTokens,
170
+ ...openAITools ? { tools: openAITools } : {}
171
+ },
172
+ { signal }
173
+ ),
174
+ `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
175
+ );
176
+ return toLLMToolResponse(completion.choices[0]?.message);
177
+ } catch (error) {
178
+ throw core.toCharivoError("provider", error, "Gemini LLM request failed");
179
+ }
180
+ }
181
+ };
182
+ function createGeminiLLMProvider(config) {
183
+ return new GeminiLLMProvider(config);
184
+ }
185
+ function toGeminiChatMessages(messages) {
186
+ return toOpenAIChatMessages(messages).map((message) => {
187
+ if (message.role !== "assistant" || !message.tool_calls?.length) {
188
+ return message;
189
+ }
190
+ return {
191
+ ...message,
192
+ tool_calls: message.tool_calls.map(
193
+ (toolCall, index) => index === 0 ? {
194
+ ...toolCall,
195
+ extra_content: {
196
+ google: { thought_signature: THOUGHT_SIGNATURE_SKIP }
197
+ }
198
+ } : toolCall
199
+ )
200
+ };
201
+ });
202
+ }
203
+ async function withTimeout(makeRequest, timeoutMessage) {
204
+ const controller = new AbortController();
205
+ let timeoutId;
206
+ const timeoutPromise = new Promise((_, reject) => {
207
+ timeoutId = setTimeout(() => {
208
+ controller.abort();
209
+ reject(new core.CharivoTimeoutError(timeoutMessage));
210
+ }, REQUEST_TIMEOUT_MS);
211
+ });
212
+ try {
213
+ return await Promise.race([makeRequest(controller.signal), timeoutPromise]);
214
+ } finally {
215
+ if (timeoutId) {
216
+ clearTimeout(timeoutId);
217
+ }
218
+ }
219
+ }
220
+
221
+ // src/gemini/index.ts
222
+ var GeminiLLMClient = class {
223
+ provider;
224
+ constructor(config) {
225
+ this.provider = createGeminiLLMProvider({
226
+ ...config,
227
+ dangerouslyAllowBrowser: true
228
+ });
229
+ }
230
+ async call(messages) {
231
+ const assistantMessage = await this.provider.generateResponse(messages);
232
+ return assistantMessage;
233
+ }
234
+ async callWithTools(messages, tools) {
235
+ return this.provider.generateResponseWithTools(messages, tools);
236
+ }
237
+ };
238
+ function createGeminiLLMClient(config) {
239
+ return new GeminiLLMClient(config);
240
+ }
241
+
242
+ exports.GeminiLLMProvider = GeminiLLMProvider;
243
+ exports.createGeminiLLMClient = createGeminiLLMClient;
244
+ exports.createGeminiLLMProvider = createGeminiLLMProvider;
245
+ //# sourceMappingURL=index.js.map
246
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/openai-tool-format.ts","../../src/gemini/provider.ts","../../src/gemini/index.ts"],"names":["CharivoProviderError","CharivoStateError","OpenAI","toCharivoError","CharivoTimeoutError"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Mapping between the neutral LLM tool contracts and the OpenAI\n * chat.completions wire format. Shared by the OpenAI provider and the OpenClaw\n * gateway provider, which speaks the same API.\n */\nimport {\n CharivoProviderError,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport type OpenAI from \"openai\";\n\nexport function toOpenAIChatMessages(\n messages: LLMMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n return messages.map((message) => {\n switch (message.role) {\n case \"tool\":\n return {\n role: \"tool\",\n tool_call_id: message.toolCallId,\n content: message.content,\n };\n case \"assistant\":\n return {\n role: \"assistant\",\n content: message.content,\n ...(message.toolCalls && message.toolCalls.length > 0\n ? { tool_calls: message.toolCalls.map(toOpenAIToolCall) }\n : {}),\n };\n case \"system\":\n case \"user\":\n return { role: message.role, content: message.content };\n }\n });\n}\n\n/**\n * Returns undefined for an empty list so callers can spread the result and\n * leave the `tools` param out entirely: an empty array would still switch the\n * model into tool mode.\n */\nexport function toOpenAITools(\n tools: ToolDefinition[],\n): OpenAI.ChatCompletionTool[] | undefined {\n if (tools.length === 0) {\n return undefined;\n }\n\n return tools.map((tool) => ({\n type: \"function\",\n function: {\n name: tool.name,\n description: tool.description,\n parameters: tool.parameters,\n },\n }));\n}\n\n/**\n * Builds the neutral tool response from a completion message. Shared by the\n * OpenAI and OpenClaw providers, which both read from the same wire shape.\n */\nexport function toLLMToolResponse(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolResponse {\n const toolCalls = readToolCalls(message);\n\n return {\n content: message?.content ?? \"\",\n ...(toolCalls.length > 0 ? { toolCalls } : {}),\n };\n}\n\n/**\n * Read the tool calls off a completion message. The SDK types promise more than\n * the wire delivers - especially through a gateway - so every field is checked\n * before it reaches the neutral contract.\n */\nfunction readToolCalls(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolCall[] {\n const rawToolCalls = message?.tool_calls;\n if (!rawToolCalls || rawToolCalls.length === 0) {\n return [];\n }\n\n return rawToolCalls.map(toLLMToolCall);\n}\n\nfunction toOpenAIToolCall(\n toolCall: LLMToolCall,\n): OpenAI.ChatCompletionMessageToolCall {\n return {\n id: toolCall.id,\n type: \"function\",\n function: {\n name: toolCall.name,\n arguments: JSON.stringify(toolCall.arguments),\n },\n };\n}\n\nfunction toLLMToolCall(raw: OpenAI.ChatCompletionMessageToolCall): LLMToolCall {\n if (!isPlainObject(raw)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const id = raw.id;\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n const name = raw.function?.name;\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"function.name\"`,\n );\n }\n\n return {\n id,\n name,\n arguments: parseToolArguments(name, raw.function.arguments),\n };\n}\n\nfunction parseToolArguments(\n name: string,\n rawArguments: string,\n): Record<string, unknown> {\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(rawArguments);\n } catch (error) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has unparsable \"function.arguments\"`,\n { cause: error instanceof Error ? error : undefined },\n );\n }\n\n if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"function.arguments\" that are not a JSON object`,\n );\n }\n\n return parsed as Record<string, unknown>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nconst GEMINI_BASE_URL =\n \"https://generativelanguage.googleapis.com/v1beta/openai/\";\nconst DEFAULT_MODEL = \"gemini-3.5-flash-lite\";\nconst REQUEST_TIMEOUT_MS = 30_000;\n\n/** Sent in place of the real thought signature Gemini returned; see `toGeminiChatMessages`. */\nconst THOUGHT_SIGNATURE_SKIP = \"skip_thought_signature_validator\";\n\nexport interface GeminiLLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\ntype GeminiToolCall = OpenAI.ChatCompletionMessageToolCall & {\n extra_content?: { google: { thought_signature: string } };\n};\n\n/**\n * `toOpenAIChatMessages`'s output widened so an assistant tool-call message can\n * carry Gemini's `extra_content.google.thought_signature` on its first tool\n * call, a field `openai`'s `ChatCompletionMessageToolCall` type does not model.\n */\ntype GeminiChatMessage =\n | Exclude<\n OpenAI.ChatCompletionMessageParam,\n OpenAI.ChatCompletionAssistantMessageParam\n >\n | (Omit<OpenAI.ChatCompletionAssistantMessageParam, \"tool_calls\"> & {\n tool_calls?: GeminiToolCall[];\n });\n\n/**\n * Gemini 3 answers HTTP 400 (\"Function call is missing a thought_signature in\n * functionCall parts\") when a resent assistant `tool_calls` turn lacks the\n * `thought_signature` Gemini attached to its first call. `LLMToolCall` has no\n * field for the real signature Gemini returned, so this provider sends a\n * documented skip placeholder instead and loses reasoning continuity across\n * tool rounds.\n */\nexport class GeminiLLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature?: number;\n private maxTokens: number;\n\n constructor(config: GeminiLLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"Gemini LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n baseURL: GEMINI_BASE_URL,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || DEFAULT_MODEL;\n this.temperature = config.temperature;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: openAIMessages,\n ...(this.temperature !== undefined\n ? { temperature: this.temperature }\n : {}),\n max_tokens: this.maxTokens,\n },\n { signal },\n ),\n `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"Gemini LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: toGeminiChatMessages(messages),\n ...(this.temperature !== undefined\n ? { temperature: this.temperature }\n : {}),\n max_tokens: this.maxTokens,\n ...(openAITools ? { tools: openAITools } : {}),\n },\n { signal },\n ),\n `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"Gemini LLM request failed\");\n }\n }\n}\n\nexport function createGeminiLLMProvider(\n config: GeminiLLMConfig,\n): GeminiLLMProvider {\n return new GeminiLLMProvider(config);\n}\n\n/**\n * Stamps the documented skip placeholder for `thought_signature` onto only\n * `tool_calls[0]` of each assistant tool-call message: Gemini attaches the real\n * signature to the first call of a parallel group, and every other message\n * (including `tool_calls[1..]`) is left as `toOpenAIChatMessages` produced it.\n */\nfunction toGeminiChatMessages(messages: LLMMessage[]): GeminiChatMessage[] {\n return toOpenAIChatMessages(messages).map((message) => {\n // `role: \"tool\"` messages pass through unchanged, with no `name` field: the\n // OpenAI-compatible endpoint resolves the function from `tool_call_id`\n // (verified across sequential and parallel tool rounds). `name` is a\n // requirement of the native `functionResponse` / Interactions surfaces, not this one.\n if (message.role !== \"assistant\" || !message.tool_calls?.length) {\n return message;\n }\n\n return {\n ...message,\n tool_calls: message.tool_calls.map((toolCall, index) =>\n index === 0\n ? {\n ...toolCall,\n extra_content: {\n google: { thought_signature: THOUGHT_SIGNATURE_SKIP },\n },\n }\n : toolCall,\n ),\n };\n });\n}\n\n/**\n * Aborts the underlying SDK request on timeout instead of only abandoning the\n * wrapper promise: the SDK stops waiting and stops retrying, and the aborted\n * request becomes a cancellation request to the server. Work Gemini already\n * accepted before the abort may still be billed.\n */\nasync function withTimeout<T>(\n makeRequest: (signal: AbortSignal) => Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n const controller = new AbortController();\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(() => {\n controller.abort();\n reject(new CharivoTimeoutError(timeoutMessage));\n }, REQUEST_TIMEOUT_MS);\n });\n\n try {\n return await Promise.race([makeRequest(controller.signal), timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createGeminiLLMProvider,\n GeminiLLMConfig,\n GeminiLLMProvider,\n} from \"./provider\";\n\nexport {\n createGeminiLLMProvider,\n GeminiLLMProvider,\n type GeminiLLMConfig,\n} from \"./provider\";\n\n// Use GeminiLLMConfig directly\nexport type GeminiLLMClientConfig = GeminiLLMConfig;\n\n/**\n * Gemini LLM Client - Stateless client that wraps the Gemini provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The API key is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass GeminiLLMClient implements LLMClient {\n private provider: GeminiLLMProvider;\n\n constructor(config: GeminiLLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createGeminiLLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Generate a response using the provider\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createGeminiLLMClient(\n config: GeminiLLMClientConfig,\n): LLMClient {\n return new GeminiLLMClient(config);\n}\n"]}
@@ -0,0 +1,136 @@
1
+ import { toOpenAITools, toLLMToolResponse, toOpenAIChatMessages } from '../chunk-N2ILPUIF.mjs';
2
+ import OpenAI from 'openai';
3
+ import { CharivoStateError, toCharivoError, CharivoTimeoutError } from '@charivo/core';
4
+
5
+ var GEMINI_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai/";
6
+ var DEFAULT_MODEL = "gemini-3.5-flash-lite";
7
+ var REQUEST_TIMEOUT_MS = 3e4;
8
+ var THOUGHT_SIGNATURE_SKIP = "skip_thought_signature_validator";
9
+ var GeminiLLMProvider = class {
10
+ openai;
11
+ model;
12
+ temperature;
13
+ maxTokens;
14
+ constructor(config) {
15
+ if (typeof window !== "undefined" && !config.dangerouslyAllowBrowser) {
16
+ throw new CharivoStateError(
17
+ "Gemini LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing"
18
+ );
19
+ }
20
+ this.openai = new OpenAI({
21
+ apiKey: config.apiKey,
22
+ baseURL: GEMINI_BASE_URL,
23
+ dangerouslyAllowBrowser: config.dangerouslyAllowBrowser
24
+ });
25
+ this.model = config.model || DEFAULT_MODEL;
26
+ this.temperature = config.temperature;
27
+ this.maxTokens = config.maxTokens || 1e3;
28
+ }
29
+ async generateResponse(messages) {
30
+ try {
31
+ const openAIMessages = messages.map((msg) => ({
32
+ role: msg.role,
33
+ content: msg.content
34
+ }));
35
+ const completion = await withTimeout(
36
+ (signal) => this.openai.chat.completions.create(
37
+ {
38
+ model: this.model,
39
+ messages: openAIMessages,
40
+ ...this.temperature !== void 0 ? { temperature: this.temperature } : {},
41
+ max_tokens: this.maxTokens
42
+ },
43
+ { signal }
44
+ ),
45
+ `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
46
+ );
47
+ return completion.choices[0]?.message?.content || "";
48
+ } catch (error) {
49
+ throw toCharivoError("provider", error, "Gemini LLM request failed");
50
+ }
51
+ }
52
+ async generateResponseWithTools(messages, tools) {
53
+ try {
54
+ const openAITools = toOpenAITools(tools);
55
+ const completion = await withTimeout(
56
+ (signal) => this.openai.chat.completions.create(
57
+ {
58
+ model: this.model,
59
+ messages: toGeminiChatMessages(messages),
60
+ ...this.temperature !== void 0 ? { temperature: this.temperature } : {},
61
+ max_tokens: this.maxTokens,
62
+ ...openAITools ? { tools: openAITools } : {}
63
+ },
64
+ { signal }
65
+ ),
66
+ `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
67
+ );
68
+ return toLLMToolResponse(completion.choices[0]?.message);
69
+ } catch (error) {
70
+ throw toCharivoError("provider", error, "Gemini LLM request failed");
71
+ }
72
+ }
73
+ };
74
+ function createGeminiLLMProvider(config) {
75
+ return new GeminiLLMProvider(config);
76
+ }
77
+ function toGeminiChatMessages(messages) {
78
+ return toOpenAIChatMessages(messages).map((message) => {
79
+ if (message.role !== "assistant" || !message.tool_calls?.length) {
80
+ return message;
81
+ }
82
+ return {
83
+ ...message,
84
+ tool_calls: message.tool_calls.map(
85
+ (toolCall, index) => index === 0 ? {
86
+ ...toolCall,
87
+ extra_content: {
88
+ google: { thought_signature: THOUGHT_SIGNATURE_SKIP }
89
+ }
90
+ } : toolCall
91
+ )
92
+ };
93
+ });
94
+ }
95
+ async function withTimeout(makeRequest, timeoutMessage) {
96
+ const controller = new AbortController();
97
+ let timeoutId;
98
+ const timeoutPromise = new Promise((_, reject) => {
99
+ timeoutId = setTimeout(() => {
100
+ controller.abort();
101
+ reject(new CharivoTimeoutError(timeoutMessage));
102
+ }, REQUEST_TIMEOUT_MS);
103
+ });
104
+ try {
105
+ return await Promise.race([makeRequest(controller.signal), timeoutPromise]);
106
+ } finally {
107
+ if (timeoutId) {
108
+ clearTimeout(timeoutId);
109
+ }
110
+ }
111
+ }
112
+
113
+ // src/gemini/index.ts
114
+ var GeminiLLMClient = class {
115
+ provider;
116
+ constructor(config) {
117
+ this.provider = createGeminiLLMProvider({
118
+ ...config,
119
+ dangerouslyAllowBrowser: true
120
+ });
121
+ }
122
+ async call(messages) {
123
+ const assistantMessage = await this.provider.generateResponse(messages);
124
+ return assistantMessage;
125
+ }
126
+ async callWithTools(messages, tools) {
127
+ return this.provider.generateResponseWithTools(messages, tools);
128
+ }
129
+ };
130
+ function createGeminiLLMClient(config) {
131
+ return new GeminiLLMClient(config);
132
+ }
133
+
134
+ export { GeminiLLMProvider, createGeminiLLMClient, createGeminiLLMProvider };
135
+ //# sourceMappingURL=index.mjs.map
136
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/gemini/provider.ts","../../src/gemini/index.ts"],"names":[],"mappings":";;;;AAgBA,IAAM,eAAA,GACJ,0DAAA;AACF,IAAM,aAAA,GAAgB,uBAAA;AACtB,IAAM,kBAAA,GAAqB,GAAA;AAG3B,IAAM,sBAAA,GAAyB,kCAAA;AAoCxB,IAAM,oBAAN,MAA+C;AAAA,EAC5C,MAAA;AAAA,EACA,KAAA;AAAA,EACA,WAAA;AAAA,EACA,SAAA;AAAA,EAER,YAAY,MAAA,EAAyB;AACnC,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,uBAAA,EAAyB;AACpE,MAAA,MAAM,IAAI,iBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,MAAA,CAAO;AAAA,MACvB,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,OAAA,EAAS,eAAA;AAAA,MACT,yBAAyB,MAAA,CAAO;AAAA,KACjC,CAAA;AAED,IAAA,IAAA,CAAK,KAAA,GAAQ,OAAO,KAAA,IAAS,aAAA;AAC7B,IAAA,IAAA,CAAK,cAAc,MAAA,CAAO,WAAA;AAC1B,IAAA,IAAA,CAAK,SAAA,GAAY,OAAO,SAAA,IAAa,GAAA;AAAA,EACvC;AAAA,EAEA,MAAM,iBACJ,QAAA,EACiB;AACjB,IAAA,IAAI;AACF,MAAA,MAAM,cAAA,GAAiB,QAAA,CAAS,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,QAC5C,MAAM,GAAA,CAAI,IAAA;AAAA,QACV,SAAS,GAAA,CAAI;AAAA,OACf,CAAE,CAAA;AAEF,MAAA,MAAM,aAAa,MAAM,WAAA;AAAA,QACvB,CAAC,MAAA,KACC,IAAA,CAAK,MAAA,CAAO,KAAK,WAAA,CAAY,MAAA;AAAA,UAC3B;AAAA,YACE,OAAO,IAAA,CAAK,KAAA;AAAA,YACZ,QAAA,EAAU,cAAA;AAAA,YACV,GAAI,KAAK,WAAA,KAAgB,KAAA,CAAA,GACrB,EAAE,WAAA,EAAa,IAAA,CAAK,WAAA,EAAY,GAChC,EAAC;AAAA,YACL,YAAY,IAAA,CAAK;AAAA,WACnB;AAAA,UACA,EAAE,MAAA;AAAO,SACX;AAAA,QACF,sCAAsC,kBAAkB,CAAA,EAAA;AAAA,OAC1D;AAEA,MAAA,OAAO,UAAA,CAAW,OAAA,CAAQ,CAAC,CAAA,EAAG,SAAS,OAAA,IAAW,EAAA;AAAA,IACpD,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,cAAA,CAAe,UAAA,EAAY,KAAA,EAAO,2BAA2B,CAAA;AAAA,IACrE;AAAA,EACF;AAAA,EAEA,MAAM,yBAAA,CACJ,QAAA,EACA,KAAA,EAC0B;AAC1B,IAAA,IAAI;AACF,MAAA,MAAM,WAAA,GAAc,cAAc,KAAK,CAAA;AAEvC,MAAA,MAAM,aAAa,MAAM,WAAA;AAAA,QACvB,CAAC,MAAA,KACC,IAAA,CAAK,MAAA,CAAO,KAAK,WAAA,CAAY,MAAA;AAAA,UAC3B;AAAA,YACE,OAAO,IAAA,CAAK,KAAA;AAAA,YACZ,QAAA,EAAU,qBAAqB,QAAQ,CAAA;AAAA,YACvC,GAAI,KAAK,WAAA,KAAgB,KAAA,CAAA,GACrB,EAAE,WAAA,EAAa,IAAA,CAAK,WAAA,EAAY,GAChC,EAAC;AAAA,YACL,YAAY,IAAA,CAAK,SAAA;AAAA,YACjB,GAAI,WAAA,GAAc,EAAE,KAAA,EAAO,WAAA,KAAgB;AAAC,WAC9C;AAAA,UACA,EAAE,MAAA;AAAO,SACX;AAAA,QACF,sCAAsC,kBAAkB,CAAA,EAAA;AAAA,OAC1D;AAEA,MAAA,OAAO,iBAAA,CAAkB,UAAA,CAAW,OAAA,CAAQ,CAAC,GAAG,OAAO,CAAA;AAAA,IACzD,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,cAAA,CAAe,UAAA,EAAY,KAAA,EAAO,2BAA2B,CAAA;AAAA,IACrE;AAAA,EACF;AACF;AAEO,SAAS,wBACd,MAAA,EACmB;AACnB,EAAA,OAAO,IAAI,kBAAkB,MAAM,CAAA;AACrC;AAQA,SAAS,qBAAqB,QAAA,EAA6C;AACzE,EAAA,OAAO,oBAAA,CAAqB,QAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,OAAA,KAAY;AAKrD,IAAA,IAAI,QAAQ,IAAA,KAAS,WAAA,IAAe,CAAC,OAAA,CAAQ,YAAY,MAAA,EAAQ;AAC/D,MAAA,OAAO,OAAA;AAAA,IACT;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,OAAA;AAAA,MACH,UAAA,EAAY,QAAQ,UAAA,CAAW,GAAA;AAAA,QAAI,CAAC,QAAA,EAAU,KAAA,KAC5C,KAAA,KAAU,CAAA,GACN;AAAA,UACE,GAAG,QAAA;AAAA,UACH,aAAA,EAAe;AAAA,YACb,MAAA,EAAQ,EAAE,iBAAA,EAAmB,sBAAA;AAAuB;AACtD,SACF,GACA;AAAA;AACN,KACF;AAAA,EACF,CAAC,CAAA;AACH;AAQA,eAAe,WAAA,CACb,aACA,cAAA,EACY;AACZ,EAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,EAAA,IAAI,SAAA;AAEJ,EAAA,MAAM,cAAA,GAAiB,IAAI,OAAA,CAAW,CAAC,GAAG,MAAA,KAAW;AACnD,IAAA,SAAA,GAAY,WAAW,MAAM;AAC3B,MAAA,UAAA,CAAW,KAAA,EAAM;AACjB,MAAA,MAAA,CAAO,IAAI,mBAAA,CAAoB,cAAc,CAAC,CAAA;AAAA,IAChD,GAAG,kBAAkB,CAAA;AAAA,EACvB,CAAC,CAAA;AAED,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,QAAQ,IAAA,CAAK,CAAC,YAAY,UAAA,CAAW,MAAM,CAAA,EAAG,cAAc,CAAC,CAAA;AAAA,EAC5E,CAAA,SAAE;AACA,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,YAAA,CAAa,SAAS,CAAA;AAAA,IACxB;AAAA,EACF;AACF;;;ACpLA,IAAM,kBAAN,MAA2C;AAAA,EACjC,QAAA;AAAA,EAER,YAAY,MAAA,EAA+B;AAGzC,IAAA,IAAA,CAAK,WAAW,uBAAA,CAAwB;AAAA,MACtC,GAAG,MAAA;AAAA,MACH,uBAAA,EAAyB;AAAA,KAC1B,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,KACJ,QAAA,EACiB;AAEjB,IAAA,MAAM,gBAAA,GAAmB,MAAM,IAAA,CAAK,QAAA,CAAS,iBAAiB,QAAQ,CAAA;AAEtE,IAAA,OAAO,gBAAA;AAAA,EACT;AAAA,EAEA,MAAM,aAAA,CACJ,QAAA,EACA,KAAA,EAC0B;AAC1B,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,yBAAA,CAA0B,QAAA,EAAU,KAAK,CAAA;AAAA,EAChE;AACF,CAAA;AAEO,SAAS,sBACd,MAAA,EACW;AACX,EAAA,OAAO,IAAI,gBAAgB,MAAM,CAAA;AACnC","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nconst GEMINI_BASE_URL =\n \"https://generativelanguage.googleapis.com/v1beta/openai/\";\nconst DEFAULT_MODEL = \"gemini-3.5-flash-lite\";\nconst REQUEST_TIMEOUT_MS = 30_000;\n\n/** Sent in place of the real thought signature Gemini returned; see `toGeminiChatMessages`. */\nconst THOUGHT_SIGNATURE_SKIP = \"skip_thought_signature_validator\";\n\nexport interface GeminiLLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\ntype GeminiToolCall = OpenAI.ChatCompletionMessageToolCall & {\n extra_content?: { google: { thought_signature: string } };\n};\n\n/**\n * `toOpenAIChatMessages`'s output widened so an assistant tool-call message can\n * carry Gemini's `extra_content.google.thought_signature` on its first tool\n * call, a field `openai`'s `ChatCompletionMessageToolCall` type does not model.\n */\ntype GeminiChatMessage =\n | Exclude<\n OpenAI.ChatCompletionMessageParam,\n OpenAI.ChatCompletionAssistantMessageParam\n >\n | (Omit<OpenAI.ChatCompletionAssistantMessageParam, \"tool_calls\"> & {\n tool_calls?: GeminiToolCall[];\n });\n\n/**\n * Gemini 3 answers HTTP 400 (\"Function call is missing a thought_signature in\n * functionCall parts\") when a resent assistant `tool_calls` turn lacks the\n * `thought_signature` Gemini attached to its first call. `LLMToolCall` has no\n * field for the real signature Gemini returned, so this provider sends a\n * documented skip placeholder instead and loses reasoning continuity across\n * tool rounds.\n */\nexport class GeminiLLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature?: number;\n private maxTokens: number;\n\n constructor(config: GeminiLLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"Gemini LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n baseURL: GEMINI_BASE_URL,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || DEFAULT_MODEL;\n this.temperature = config.temperature;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: openAIMessages,\n ...(this.temperature !== undefined\n ? { temperature: this.temperature }\n : {}),\n max_tokens: this.maxTokens,\n },\n { signal },\n ),\n `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"Gemini LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: toGeminiChatMessages(messages),\n ...(this.temperature !== undefined\n ? { temperature: this.temperature }\n : {}),\n max_tokens: this.maxTokens,\n ...(openAITools ? { tools: openAITools } : {}),\n },\n { signal },\n ),\n `Gemini LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"Gemini LLM request failed\");\n }\n }\n}\n\nexport function createGeminiLLMProvider(\n config: GeminiLLMConfig,\n): GeminiLLMProvider {\n return new GeminiLLMProvider(config);\n}\n\n/**\n * Stamps the documented skip placeholder for `thought_signature` onto only\n * `tool_calls[0]` of each assistant tool-call message: Gemini attaches the real\n * signature to the first call of a parallel group, and every other message\n * (including `tool_calls[1..]`) is left as `toOpenAIChatMessages` produced it.\n */\nfunction toGeminiChatMessages(messages: LLMMessage[]): GeminiChatMessage[] {\n return toOpenAIChatMessages(messages).map((message) => {\n // `role: \"tool\"` messages pass through unchanged, with no `name` field: the\n // OpenAI-compatible endpoint resolves the function from `tool_call_id`\n // (verified across sequential and parallel tool rounds). `name` is a\n // requirement of the native `functionResponse` / Interactions surfaces, not this one.\n if (message.role !== \"assistant\" || !message.tool_calls?.length) {\n return message;\n }\n\n return {\n ...message,\n tool_calls: message.tool_calls.map((toolCall, index) =>\n index === 0\n ? {\n ...toolCall,\n extra_content: {\n google: { thought_signature: THOUGHT_SIGNATURE_SKIP },\n },\n }\n : toolCall,\n ),\n };\n });\n}\n\n/**\n * Aborts the underlying SDK request on timeout instead of only abandoning the\n * wrapper promise: the SDK stops waiting and stops retrying, and the aborted\n * request becomes a cancellation request to the server. Work Gemini already\n * accepted before the abort may still be billed.\n */\nasync function withTimeout<T>(\n makeRequest: (signal: AbortSignal) => Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n const controller = new AbortController();\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(() => {\n controller.abort();\n reject(new CharivoTimeoutError(timeoutMessage));\n }, REQUEST_TIMEOUT_MS);\n });\n\n try {\n return await Promise.race([makeRequest(controller.signal), timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createGeminiLLMProvider,\n GeminiLLMConfig,\n GeminiLLMProvider,\n} from \"./provider\";\n\nexport {\n createGeminiLLMProvider,\n GeminiLLMProvider,\n type GeminiLLMConfig,\n} from \"./provider\";\n\n// Use GeminiLLMConfig directly\nexport type GeminiLLMClientConfig = GeminiLLMConfig;\n\n/**\n * Gemini LLM Client - Stateless client that wraps the Gemini provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The API key is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass GeminiLLMClient implements LLMClient {\n private provider: GeminiLLMProvider;\n\n constructor(config: GeminiLLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createGeminiLLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Generate a response using the provider\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createGeminiLLMClient(\n config: GeminiLLMClientConfig,\n): LLMClient {\n return new GeminiLLMClient(config);\n}\n"]}
@@ -137,12 +137,15 @@ var OpenAILLMProvider = class {
137
137
  content: msg.content
138
138
  }));
139
139
  const completion = await withTimeout(
140
- this.openai.chat.completions.create({
141
- model: this.model,
142
- messages: openAIMessages,
143
- temperature: this.temperature,
144
- max_tokens: this.maxTokens
145
- }),
140
+ (signal) => this.openai.chat.completions.create(
141
+ {
142
+ model: this.model,
143
+ messages: openAIMessages,
144
+ temperature: this.temperature,
145
+ max_tokens: this.maxTokens
146
+ },
147
+ { signal }
148
+ ),
146
149
  `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
147
150
  );
148
151
  return completion.choices[0]?.message?.content || "";
@@ -154,13 +157,16 @@ var OpenAILLMProvider = class {
154
157
  try {
155
158
  const openAITools = toOpenAITools(tools);
156
159
  const completion = await withTimeout(
157
- this.openai.chat.completions.create({
158
- model: this.model,
159
- messages: toOpenAIChatMessages(messages),
160
- temperature: this.temperature,
161
- max_tokens: this.maxTokens,
162
- ...openAITools ? { tools: openAITools } : {}
163
- }),
160
+ (signal) => this.openai.chat.completions.create(
161
+ {
162
+ model: this.model,
163
+ messages: toOpenAIChatMessages(messages),
164
+ temperature: this.temperature,
165
+ max_tokens: this.maxTokens,
166
+ ...openAITools ? { tools: openAITools } : {}
167
+ },
168
+ { signal }
169
+ ),
164
170
  `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
165
171
  );
166
172
  return toLLMToolResponse(completion.choices[0]?.message);
@@ -172,16 +178,17 @@ var OpenAILLMProvider = class {
172
178
  function createOpenAILLMProvider(config) {
173
179
  return new OpenAILLMProvider(config);
174
180
  }
175
- async function withTimeout(promise, timeoutMessage) {
181
+ async function withTimeout(makeRequest, timeoutMessage) {
182
+ const controller = new AbortController();
176
183
  let timeoutId;
177
184
  const timeoutPromise = new Promise((_, reject) => {
178
- timeoutId = setTimeout(
179
- () => reject(new core.CharivoTimeoutError(timeoutMessage)),
180
- REQUEST_TIMEOUT_MS
181
- );
185
+ timeoutId = setTimeout(() => {
186
+ controller.abort();
187
+ reject(new core.CharivoTimeoutError(timeoutMessage));
188
+ }, REQUEST_TIMEOUT_MS);
182
189
  });
183
190
  try {
184
- return await Promise.race([promise, timeoutPromise]);
191
+ return await Promise.race([makeRequest(controller.signal), timeoutPromise]);
185
192
  } finally {
186
193
  if (timeoutId) {
187
194
  clearTimeout(timeoutId);
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/openai-tool-format.ts","../../src/openai/provider.ts","../../src/openai/index.ts"],"names":["CharivoProviderError","CharivoStateError","OpenAI","toCharivoError","CharivoTimeoutError"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Mapping between the neutral LLM tool contracts and the OpenAI\n * chat.completions wire format. Shared by the OpenAI provider and the OpenClaw\n * gateway provider, which speaks the same API.\n */\nimport {\n CharivoProviderError,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport type OpenAI from \"openai\";\n\nexport function toOpenAIChatMessages(\n messages: LLMMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n return messages.map((message) => {\n switch (message.role) {\n case \"tool\":\n return {\n role: \"tool\",\n tool_call_id: message.toolCallId,\n content: message.content,\n };\n case \"assistant\":\n return {\n role: \"assistant\",\n content: message.content,\n ...(message.toolCalls && message.toolCalls.length > 0\n ? { tool_calls: message.toolCalls.map(toOpenAIToolCall) }\n : {}),\n };\n case \"system\":\n case \"user\":\n return { role: message.role, content: message.content };\n }\n });\n}\n\n/**\n * Returns undefined for an empty list so callers can spread the result and\n * leave the `tools` param out entirely: an empty array would still switch the\n * model into tool mode.\n */\nexport function toOpenAITools(\n tools: ToolDefinition[],\n): OpenAI.ChatCompletionTool[] | undefined {\n if (tools.length === 0) {\n return undefined;\n }\n\n return tools.map((tool) => ({\n type: \"function\",\n function: {\n name: tool.name,\n description: tool.description,\n parameters: tool.parameters,\n },\n }));\n}\n\n/**\n * Builds the neutral tool response from a completion message. Shared by the\n * OpenAI and OpenClaw providers, which both read from the same wire shape.\n */\nexport function toLLMToolResponse(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolResponse {\n const toolCalls = readToolCalls(message);\n\n return {\n content: message?.content ?? \"\",\n ...(toolCalls.length > 0 ? { toolCalls } : {}),\n };\n}\n\n/**\n * Read the tool calls off a completion message. The SDK types promise more than\n * the wire delivers - especially through a gateway - so every field is checked\n * before it reaches the neutral contract.\n */\nfunction readToolCalls(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolCall[] {\n const rawToolCalls = message?.tool_calls;\n if (!rawToolCalls || rawToolCalls.length === 0) {\n return [];\n }\n\n return rawToolCalls.map(toLLMToolCall);\n}\n\nfunction toOpenAIToolCall(\n toolCall: LLMToolCall,\n): OpenAI.ChatCompletionMessageToolCall {\n return {\n id: toolCall.id,\n type: \"function\",\n function: {\n name: toolCall.name,\n arguments: JSON.stringify(toolCall.arguments),\n },\n };\n}\n\nfunction toLLMToolCall(raw: OpenAI.ChatCompletionMessageToolCall): LLMToolCall {\n if (!isPlainObject(raw)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const id = raw.id;\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n const name = raw.function?.name;\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"function.name\"`,\n );\n }\n\n return {\n id,\n name,\n arguments: parseToolArguments(name, raw.function.arguments),\n };\n}\n\nfunction parseToolArguments(\n name: string,\n rawArguments: string,\n): Record<string, unknown> {\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(rawArguments);\n } catch (error) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has unparsable \"function.arguments\"`,\n { cause: error instanceof Error ? error : undefined },\n );\n }\n\n if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"function.arguments\" that are not a JSON object`,\n );\n }\n\n return parsed as Record<string, unknown>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n }),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: toOpenAIChatMessages(messages),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(openAITools ? { tools: openAITools } : {}),\n }),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\nasync function withTimeout<T>(\n promise: Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(\n () => reject(new CharivoTimeoutError(timeoutMessage)),\n REQUEST_TIMEOUT_MS,\n );\n });\n\n try {\n return await Promise.race([promise, timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenAILLMProvider,\n OpenAILLMProvider,\n type OpenAILLMConfig,\n} from \"./provider\";\n\n// Use OpenAILLMConfig directly\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - Stateless client that wraps the OpenAI provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The API key is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Generate a response using the provider\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): LLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
1
+ {"version":3,"sources":["../../src/openai-tool-format.ts","../../src/openai/provider.ts","../../src/openai/index.ts"],"names":["CharivoProviderError","CharivoStateError","OpenAI","toCharivoError","CharivoTimeoutError"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Mapping between the neutral LLM tool contracts and the OpenAI\n * chat.completions wire format. Shared by the OpenAI provider and the OpenClaw\n * gateway provider, which speaks the same API.\n */\nimport {\n CharivoProviderError,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport type OpenAI from \"openai\";\n\nexport function toOpenAIChatMessages(\n messages: LLMMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n return messages.map((message) => {\n switch (message.role) {\n case \"tool\":\n return {\n role: \"tool\",\n tool_call_id: message.toolCallId,\n content: message.content,\n };\n case \"assistant\":\n return {\n role: \"assistant\",\n content: message.content,\n ...(message.toolCalls && message.toolCalls.length > 0\n ? { tool_calls: message.toolCalls.map(toOpenAIToolCall) }\n : {}),\n };\n case \"system\":\n case \"user\":\n return { role: message.role, content: message.content };\n }\n });\n}\n\n/**\n * Returns undefined for an empty list so callers can spread the result and\n * leave the `tools` param out entirely: an empty array would still switch the\n * model into tool mode.\n */\nexport function toOpenAITools(\n tools: ToolDefinition[],\n): OpenAI.ChatCompletionTool[] | undefined {\n if (tools.length === 0) {\n return undefined;\n }\n\n return tools.map((tool) => ({\n type: \"function\",\n function: {\n name: tool.name,\n description: tool.description,\n parameters: tool.parameters,\n },\n }));\n}\n\n/**\n * Builds the neutral tool response from a completion message. Shared by the\n * OpenAI and OpenClaw providers, which both read from the same wire shape.\n */\nexport function toLLMToolResponse(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolResponse {\n const toolCalls = readToolCalls(message);\n\n return {\n content: message?.content ?? \"\",\n ...(toolCalls.length > 0 ? { toolCalls } : {}),\n };\n}\n\n/**\n * Read the tool calls off a completion message. The SDK types promise more than\n * the wire delivers - especially through a gateway - so every field is checked\n * before it reaches the neutral contract.\n */\nfunction readToolCalls(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolCall[] {\n const rawToolCalls = message?.tool_calls;\n if (!rawToolCalls || rawToolCalls.length === 0) {\n return [];\n }\n\n return rawToolCalls.map(toLLMToolCall);\n}\n\nfunction toOpenAIToolCall(\n toolCall: LLMToolCall,\n): OpenAI.ChatCompletionMessageToolCall {\n return {\n id: toolCall.id,\n type: \"function\",\n function: {\n name: toolCall.name,\n arguments: JSON.stringify(toolCall.arguments),\n },\n };\n}\n\nfunction toLLMToolCall(raw: OpenAI.ChatCompletionMessageToolCall): LLMToolCall {\n if (!isPlainObject(raw)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const id = raw.id;\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n const name = raw.function?.name;\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"function.name\"`,\n );\n }\n\n return {\n id,\n name,\n arguments: parseToolArguments(name, raw.function.arguments),\n };\n}\n\nfunction parseToolArguments(\n name: string,\n rawArguments: string,\n): Record<string, unknown> {\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(rawArguments);\n } catch (error) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has unparsable \"function.arguments\"`,\n { cause: error instanceof Error ? error : undefined },\n );\n }\n\n if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"function.arguments\" that are not a JSON object`,\n );\n }\n\n return parsed as Record<string, unknown>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n },\n { signal },\n ),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: toOpenAIChatMessages(messages),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(openAITools ? { tools: openAITools } : {}),\n },\n { signal },\n ),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\n/**\n * Aborts the underlying SDK request on timeout instead of only abandoning the\n * wrapper promise: the SDK stops waiting and stops retrying, and the aborted\n * request becomes a cancellation request to the server. Work OpenAI already\n * accepted before the abort may still be billed.\n */\nasync function withTimeout<T>(\n makeRequest: (signal: AbortSignal) => Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n const controller = new AbortController();\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(() => {\n controller.abort();\n reject(new CharivoTimeoutError(timeoutMessage));\n }, REQUEST_TIMEOUT_MS);\n });\n\n try {\n return await Promise.race([makeRequest(controller.signal), timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenAILLMProvider,\n OpenAILLMProvider,\n type OpenAILLMConfig,\n} from \"./provider\";\n\n// Use OpenAILLMConfig directly\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - Stateless client that wraps the OpenAI provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The API key is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Generate a response using the provider\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): LLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
@@ -29,12 +29,15 @@ var OpenAILLMProvider = class {
29
29
  content: msg.content
30
30
  }));
31
31
  const completion = await withTimeout(
32
- this.openai.chat.completions.create({
33
- model: this.model,
34
- messages: openAIMessages,
35
- temperature: this.temperature,
36
- max_tokens: this.maxTokens
37
- }),
32
+ (signal) => this.openai.chat.completions.create(
33
+ {
34
+ model: this.model,
35
+ messages: openAIMessages,
36
+ temperature: this.temperature,
37
+ max_tokens: this.maxTokens
38
+ },
39
+ { signal }
40
+ ),
38
41
  `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
39
42
  );
40
43
  return completion.choices[0]?.message?.content || "";
@@ -46,13 +49,16 @@ var OpenAILLMProvider = class {
46
49
  try {
47
50
  const openAITools = toOpenAITools(tools);
48
51
  const completion = await withTimeout(
49
- this.openai.chat.completions.create({
50
- model: this.model,
51
- messages: toOpenAIChatMessages(messages),
52
- temperature: this.temperature,
53
- max_tokens: this.maxTokens,
54
- ...openAITools ? { tools: openAITools } : {}
55
- }),
52
+ (signal) => this.openai.chat.completions.create(
53
+ {
54
+ model: this.model,
55
+ messages: toOpenAIChatMessages(messages),
56
+ temperature: this.temperature,
57
+ max_tokens: this.maxTokens,
58
+ ...openAITools ? { tools: openAITools } : {}
59
+ },
60
+ { signal }
61
+ ),
56
62
  `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
57
63
  );
58
64
  return toLLMToolResponse(completion.choices[0]?.message);
@@ -64,16 +70,17 @@ var OpenAILLMProvider = class {
64
70
  function createOpenAILLMProvider(config) {
65
71
  return new OpenAILLMProvider(config);
66
72
  }
67
- async function withTimeout(promise, timeoutMessage) {
73
+ async function withTimeout(makeRequest, timeoutMessage) {
74
+ const controller = new AbortController();
68
75
  let timeoutId;
69
76
  const timeoutPromise = new Promise((_, reject) => {
70
- timeoutId = setTimeout(
71
- () => reject(new CharivoTimeoutError(timeoutMessage)),
72
- REQUEST_TIMEOUT_MS
73
- );
77
+ timeoutId = setTimeout(() => {
78
+ controller.abort();
79
+ reject(new CharivoTimeoutError(timeoutMessage));
80
+ }, REQUEST_TIMEOUT_MS);
74
81
  });
75
82
  try {
76
- return await Promise.race([promise, timeoutPromise]);
83
+ return await Promise.race([makeRequest(controller.signal), timeoutPromise]);
77
84
  } finally {
78
85
  if (timeoutId) {
79
86
  clearTimeout(timeoutId);
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/openai/provider.ts","../../src/openai/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n }),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: toOpenAIChatMessages(messages),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(openAITools ? { tools: openAITools } : {}),\n }),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\nasync function withTimeout<T>(\n promise: Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(\n () => reject(new CharivoTimeoutError(timeoutMessage)),\n REQUEST_TIMEOUT_MS,\n );\n });\n\n try {\n return await Promise.race([promise, timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenAILLMProvider,\n OpenAILLMProvider,\n type OpenAILLMConfig,\n} from \"./provider\";\n\n// Use OpenAILLMConfig directly\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - Stateless client that wraps the OpenAI provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The API key is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Generate a response using the provider\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): LLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
1
+ {"version":3,"sources":["../../src/openai/provider.ts","../../src/openai/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n },\n { signal },\n ),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await withTimeout(\n (signal) =>\n this.openai.chat.completions.create(\n {\n model: this.model,\n messages: toOpenAIChatMessages(messages),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(openAITools ? { tools: openAITools } : {}),\n },\n { signal },\n ),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\n/**\n * Aborts the underlying SDK request on timeout instead of only abandoning the\n * wrapper promise: the SDK stops waiting and stops retrying, and the aborted\n * request becomes a cancellation request to the server. Work OpenAI already\n * accepted before the abort may still be billed.\n */\nasync function withTimeout<T>(\n makeRequest: (signal: AbortSignal) => Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n const controller = new AbortController();\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(() => {\n controller.abort();\n reject(new CharivoTimeoutError(timeoutMessage));\n }, REQUEST_TIMEOUT_MS);\n });\n\n try {\n return await Promise.race([makeRequest(controller.signal), timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenAILLMProvider,\n OpenAILLMProvider,\n type OpenAILLMConfig,\n} from \"./provider\";\n\n// Use OpenAILLMConfig directly\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - Stateless client that wraps the OpenAI provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The API key is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Generate a response using the provider\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): LLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
@@ -36,6 +36,13 @@ interface OpenClawLLMConfig {
36
36
  sessionKey?: string;
37
37
  dangerouslyAllowBrowser?: boolean;
38
38
  }
39
+ /**
40
+ * Deliberately has no request timeout, unlike the OpenAI and Gemini providers.
41
+ * The gateway fronts an agent harness whose runs legitimately take minutes, so
42
+ * any cap short enough to be useful against a hang would also cut off ordinary
43
+ * work. Neither method takes an `AbortSignal`, so a caller can stop waiting on
44
+ * the promise but cannot cancel the run behind it.
45
+ */
39
46
  declare class OpenClawLLMProvider implements LLMProvider {
40
47
  private openai;
41
48
  private model;
@@ -36,6 +36,13 @@ interface OpenClawLLMConfig {
36
36
  sessionKey?: string;
37
37
  dangerouslyAllowBrowser?: boolean;
38
38
  }
39
+ /**
40
+ * Deliberately has no request timeout, unlike the OpenAI and Gemini providers.
41
+ * The gateway fronts an agent harness whose runs legitimately take minutes, so
42
+ * any cap short enough to be useful against a hang would also cut off ordinary
43
+ * work. Neither method takes an `AbortSignal`, so a caller can stop waiting on
44
+ * the promise but cannot cancel the run behind it.
45
+ */
39
46
  declare class OpenClawLLMProvider implements LLMProvider {
40
47
  private openai;
41
48
  private model;
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/openai-tool-format.ts","../../src/openclaw/provider.ts","../../src/openclaw/index.ts"],"names":["CharivoProviderError","CharivoStateError","OpenAI","toCharivoError"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Mapping between the neutral LLM tool contracts and the OpenAI\n * chat.completions wire format. Shared by the OpenAI provider and the OpenClaw\n * gateway provider, which speaks the same API.\n */\nimport {\n CharivoProviderError,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport type OpenAI from \"openai\";\n\nexport function toOpenAIChatMessages(\n messages: LLMMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n return messages.map((message) => {\n switch (message.role) {\n case \"tool\":\n return {\n role: \"tool\",\n tool_call_id: message.toolCallId,\n content: message.content,\n };\n case \"assistant\":\n return {\n role: \"assistant\",\n content: message.content,\n ...(message.toolCalls && message.toolCalls.length > 0\n ? { tool_calls: message.toolCalls.map(toOpenAIToolCall) }\n : {}),\n };\n case \"system\":\n case \"user\":\n return { role: message.role, content: message.content };\n }\n });\n}\n\n/**\n * Returns undefined for an empty list so callers can spread the result and\n * leave the `tools` param out entirely: an empty array would still switch the\n * model into tool mode.\n */\nexport function toOpenAITools(\n tools: ToolDefinition[],\n): OpenAI.ChatCompletionTool[] | undefined {\n if (tools.length === 0) {\n return undefined;\n }\n\n return tools.map((tool) => ({\n type: \"function\",\n function: {\n name: tool.name,\n description: tool.description,\n parameters: tool.parameters,\n },\n }));\n}\n\n/**\n * Builds the neutral tool response from a completion message. Shared by the\n * OpenAI and OpenClaw providers, which both read from the same wire shape.\n */\nexport function toLLMToolResponse(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolResponse {\n const toolCalls = readToolCalls(message);\n\n return {\n content: message?.content ?? \"\",\n ...(toolCalls.length > 0 ? { toolCalls } : {}),\n };\n}\n\n/**\n * Read the tool calls off a completion message. The SDK types promise more than\n * the wire delivers - especially through a gateway - so every field is checked\n * before it reaches the neutral contract.\n */\nfunction readToolCalls(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolCall[] {\n const rawToolCalls = message?.tool_calls;\n if (!rawToolCalls || rawToolCalls.length === 0) {\n return [];\n }\n\n return rawToolCalls.map(toLLMToolCall);\n}\n\nfunction toOpenAIToolCall(\n toolCall: LLMToolCall,\n): OpenAI.ChatCompletionMessageToolCall {\n return {\n id: toolCall.id,\n type: \"function\",\n function: {\n name: toolCall.name,\n arguments: JSON.stringify(toolCall.arguments),\n },\n };\n}\n\nfunction toLLMToolCall(raw: OpenAI.ChatCompletionMessageToolCall): LLMToolCall {\n if (!isPlainObject(raw)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const id = raw.id;\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n const name = raw.function?.name;\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"function.name\"`,\n );\n }\n\n return {\n id,\n name,\n arguments: parseToolArguments(name, raw.function.arguments),\n };\n}\n\nfunction parseToolArguments(\n name: string,\n rawArguments: string,\n): Record<string, unknown> {\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(rawArguments);\n } catch (error) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has unparsable \"function.arguments\"`,\n { cause: error instanceof Error ? error : undefined },\n );\n }\n\n if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"function.arguments\" that are not a JSON object`,\n );\n }\n\n return parsed as Record<string, unknown>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nexport interface OpenClawLLMConfig {\n token: string;\n baseURL?: string;\n /**\n * Target a specific agent on the gateway.\n * When omitted, the gateway's configured default agent handles the request.\n */\n agentId?: string;\n /**\n * Agent target, not a backend model name. The gateway resolves this to an\n * agent: `openclaw`, `openclaw/default`, or `openclaw/<agentId>`.\n *\n * @default \"openclaw/default\"\n */\n model?: string;\n temperature?: number;\n maxTokens?: number;\n /**\n * Pins the conversation to a server-side session on the gateway.\n *\n * The gateway keeps conversation state itself, but without an identifier it\n * opens a fresh session per request: nothing is persisted between turns and\n * each one strands a throwaway session. Sending this as the `user` field makes\n * the gateway derive a stable session key from it.\n *\n * When set, past turns are not resent — the gateway already holds them. The\n * system prompt is still sent every turn so the persona survives a dropped\n * session.\n *\n * Treat it as a conversation-scoped identifier (e.g. a UUID per conversation,\n * rotated when the user resets the chat). Rotating it is the only way to reset\n * the conversation; the gateway keeps the old transcript under the old key.\n */\n sessionKey?: string;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenClawLLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n private sessionKey?: string;\n\n constructor(config: OpenClawLLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenClaw LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.token,\n baseURL: config.baseURL || \"http://127.0.0.1:18789/v1\",\n defaultHeaders: config.agentId\n ? { \"x-openclaw-agent-id\": config.agentId }\n : undefined,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"openclaw/default\";\n this.temperature = config.temperature ?? 0.7;\n this.maxTokens = config.maxTokens || 1000;\n this.sessionKey = config.sessionKey;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = this.selectMessages(messages).map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n });\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: toOpenAIChatMessages(this.selectMessages(messages)),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n ...(openAITools ? { tools: openAITools } : {}),\n });\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n /**\n * With a pinned session the gateway already holds the past turns, and resending\n * them would flatten a duplicate copy of the history on top of its own. Keep the\n * system prompts (cheap persona insurance if the session was dropped) and only\n * what the gateway has not recorded yet:\n * - mid tool round, that is the trailing run of tool results (the gateway\n * generated the assistant tool-call turn that asked for them itself);\n * - otherwise, the latest turn.\n */\n private selectMessages<T extends { role: string }>(messages: T[]): T[] {\n const latest = messages[messages.length - 1];\n if (!this.sessionKey || !latest) {\n return messages;\n }\n\n const systemMessages = messages.filter((msg) => msg.role === \"system\");\n\n if (latest.role === \"tool\") {\n return [...systemMessages, ...trailingToolMessages(messages)];\n }\n\n return latest.role === \"system\"\n ? systemMessages\n : [...systemMessages, latest];\n }\n}\n\n/** The unbroken run of tool results at the end of the conversation. */\nfunction trailingToolMessages<T extends { role: string }>(messages: T[]): T[] {\n let start = messages.length;\n while (start > 0 && messages[start - 1]!.role === \"tool\") {\n start -= 1;\n }\n\n return messages.slice(start);\n}\n\nexport function createOpenClawLLMProvider(\n config: OpenClawLLMConfig,\n): OpenClawLLMProvider {\n return new OpenClawLLMProvider(config);\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenClawLLMProvider,\n OpenClawLLMConfig,\n OpenClawLLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenClawLLMProvider,\n OpenClawLLMProvider,\n type OpenClawLLMConfig,\n} from \"./provider\";\n\n// No `sessionKey` here, unlike the provider config. Pinning the gateway\n// session requires rotating it on reset, and this client is driven by\n// LLMManager, whose clearHistory()/character switch clear only local history and\n// cannot reach the client. A pinned session would survive that reset and silently\n// replay the old conversation. Server routes construct the provider themselves and\n// can rotate the key, so the option lives there instead.\nexport type OpenClawLLMClientConfig = Omit<OpenClawLLMConfig, \"sessionKey\">;\n\n/**\n * OpenClaw LLM Client - Stateless client that wraps the OpenClaw provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The token is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenClawLLMClient implements LLMClient {\n private provider: OpenClawLLMProvider;\n\n constructor(config: OpenClawLLMClientConfig) {\n // Strip sessionKey at runtime too: an untyped JS caller can bypass the\n // Omit above and pass it anyway.\n const { sessionKey: _sessionKey, ...rest } = config as OpenClawLLMConfig;\n\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenClawLLMProvider({\n ...rest,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n return this.provider.generateResponse(messages);\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenClawLLMClient(\n config: OpenClawLLMClientConfig,\n): LLMClient {\n return new OpenClawLLMClient(config);\n}\n"]}
1
+ {"version":3,"sources":["../../src/openai-tool-format.ts","../../src/openclaw/provider.ts","../../src/openclaw/index.ts"],"names":["CharivoProviderError","CharivoStateError","OpenAI","toCharivoError"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Mapping between the neutral LLM tool contracts and the OpenAI\n * chat.completions wire format. Shared by the OpenAI provider and the OpenClaw\n * gateway provider, which speaks the same API.\n */\nimport {\n CharivoProviderError,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport type OpenAI from \"openai\";\n\nexport function toOpenAIChatMessages(\n messages: LLMMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n return messages.map((message) => {\n switch (message.role) {\n case \"tool\":\n return {\n role: \"tool\",\n tool_call_id: message.toolCallId,\n content: message.content,\n };\n case \"assistant\":\n return {\n role: \"assistant\",\n content: message.content,\n ...(message.toolCalls && message.toolCalls.length > 0\n ? { tool_calls: message.toolCalls.map(toOpenAIToolCall) }\n : {}),\n };\n case \"system\":\n case \"user\":\n return { role: message.role, content: message.content };\n }\n });\n}\n\n/**\n * Returns undefined for an empty list so callers can spread the result and\n * leave the `tools` param out entirely: an empty array would still switch the\n * model into tool mode.\n */\nexport function toOpenAITools(\n tools: ToolDefinition[],\n): OpenAI.ChatCompletionTool[] | undefined {\n if (tools.length === 0) {\n return undefined;\n }\n\n return tools.map((tool) => ({\n type: \"function\",\n function: {\n name: tool.name,\n description: tool.description,\n parameters: tool.parameters,\n },\n }));\n}\n\n/**\n * Builds the neutral tool response from a completion message. Shared by the\n * OpenAI and OpenClaw providers, which both read from the same wire shape.\n */\nexport function toLLMToolResponse(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolResponse {\n const toolCalls = readToolCalls(message);\n\n return {\n content: message?.content ?? \"\",\n ...(toolCalls.length > 0 ? { toolCalls } : {}),\n };\n}\n\n/**\n * Read the tool calls off a completion message. The SDK types promise more than\n * the wire delivers - especially through a gateway - so every field is checked\n * before it reaches the neutral contract.\n */\nfunction readToolCalls(\n message: OpenAI.ChatCompletionMessage | undefined,\n): LLMToolCall[] {\n const rawToolCalls = message?.tool_calls;\n if (!rawToolCalls || rawToolCalls.length === 0) {\n return [];\n }\n\n return rawToolCalls.map(toLLMToolCall);\n}\n\nfunction toOpenAIToolCall(\n toolCall: LLMToolCall,\n): OpenAI.ChatCompletionMessageToolCall {\n return {\n id: toolCall.id,\n type: \"function\",\n function: {\n name: toolCall.name,\n arguments: JSON.stringify(toolCall.arguments),\n },\n };\n}\n\nfunction toLLMToolCall(raw: OpenAI.ChatCompletionMessageToolCall): LLMToolCall {\n if (!isPlainObject(raw)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const id = raw.id;\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n const name = raw.function?.name;\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"function.name\"`,\n );\n }\n\n return {\n id,\n name,\n arguments: parseToolArguments(name, raw.function.arguments),\n };\n}\n\nfunction parseToolArguments(\n name: string,\n rawArguments: string,\n): Record<string, unknown> {\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(rawArguments);\n } catch (error) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has unparsable \"function.arguments\"`,\n { cause: error instanceof Error ? error : undefined },\n );\n }\n\n if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"function.arguments\" that are not a JSON object`,\n );\n }\n\n return parsed as Record<string, unknown>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nexport interface OpenClawLLMConfig {\n token: string;\n baseURL?: string;\n /**\n * Target a specific agent on the gateway.\n * When omitted, the gateway's configured default agent handles the request.\n */\n agentId?: string;\n /**\n * Agent target, not a backend model name. The gateway resolves this to an\n * agent: `openclaw`, `openclaw/default`, or `openclaw/<agentId>`.\n *\n * @default \"openclaw/default\"\n */\n model?: string;\n temperature?: number;\n maxTokens?: number;\n /**\n * Pins the conversation to a server-side session on the gateway.\n *\n * The gateway keeps conversation state itself, but without an identifier it\n * opens a fresh session per request: nothing is persisted between turns and\n * each one strands a throwaway session. Sending this as the `user` field makes\n * the gateway derive a stable session key from it.\n *\n * When set, past turns are not resent — the gateway already holds them. The\n * system prompt is still sent every turn so the persona survives a dropped\n * session.\n *\n * Treat it as a conversation-scoped identifier (e.g. a UUID per conversation,\n * rotated when the user resets the chat). Rotating it is the only way to reset\n * the conversation; the gateway keeps the old transcript under the old key.\n */\n sessionKey?: string;\n dangerouslyAllowBrowser?: boolean;\n}\n\n/**\n * Deliberately has no request timeout, unlike the OpenAI and Gemini providers.\n * The gateway fronts an agent harness whose runs legitimately take minutes, so\n * any cap short enough to be useful against a hang would also cut off ordinary\n * work. Neither method takes an `AbortSignal`, so a caller can stop waiting on\n * the promise but cannot cancel the run behind it.\n */\nexport class OpenClawLLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n private sessionKey?: string;\n\n constructor(config: OpenClawLLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenClaw LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.token,\n baseURL: config.baseURL || \"http://127.0.0.1:18789/v1\",\n defaultHeaders: config.agentId\n ? { \"x-openclaw-agent-id\": config.agentId }\n : undefined,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"openclaw/default\";\n this.temperature = config.temperature ?? 0.7;\n this.maxTokens = config.maxTokens || 1000;\n this.sessionKey = config.sessionKey;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = this.selectMessages(messages).map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n });\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: toOpenAIChatMessages(this.selectMessages(messages)),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n ...(openAITools ? { tools: openAITools } : {}),\n });\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n /**\n * With a pinned session the gateway already holds the past turns, and resending\n * them would flatten a duplicate copy of the history on top of its own. Keep the\n * system prompts (cheap persona insurance if the session was dropped) and only\n * what the gateway has not recorded yet:\n * - mid tool round, that is the trailing run of tool results (the gateway\n * generated the assistant tool-call turn that asked for them itself);\n * - otherwise, the latest turn.\n */\n private selectMessages<T extends { role: string }>(messages: T[]): T[] {\n const latest = messages[messages.length - 1];\n if (!this.sessionKey || !latest) {\n return messages;\n }\n\n const systemMessages = messages.filter((msg) => msg.role === \"system\");\n\n if (latest.role === \"tool\") {\n return [...systemMessages, ...trailingToolMessages(messages)];\n }\n\n return latest.role === \"system\"\n ? systemMessages\n : [...systemMessages, latest];\n }\n}\n\n/** The unbroken run of tool results at the end of the conversation. */\nfunction trailingToolMessages<T extends { role: string }>(messages: T[]): T[] {\n let start = messages.length;\n while (start > 0 && messages[start - 1]!.role === \"tool\") {\n start -= 1;\n }\n\n return messages.slice(start);\n}\n\nexport function createOpenClawLLMProvider(\n config: OpenClawLLMConfig,\n): OpenClawLLMProvider {\n return new OpenClawLLMProvider(config);\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenClawLLMProvider,\n OpenClawLLMConfig,\n OpenClawLLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenClawLLMProvider,\n OpenClawLLMProvider,\n type OpenClawLLMConfig,\n} from \"./provider\";\n\n// No `sessionKey` here, unlike the provider config. Pinning the gateway\n// session requires rotating it on reset, and this client is driven by\n// LLMManager, whose clearHistory()/character switch clear only local history and\n// cannot reach the client. A pinned session would survive that reset and silently\n// replay the old conversation. Server routes construct the provider themselves and\n// can rotate the key, so the option lives there instead.\nexport type OpenClawLLMClientConfig = Omit<OpenClawLLMConfig, \"sessionKey\">;\n\n/**\n * OpenClaw LLM Client - Stateless client that wraps the OpenClaw provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The token is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenClawLLMClient implements LLMClient {\n private provider: OpenClawLLMProvider;\n\n constructor(config: OpenClawLLMClientConfig) {\n // Strip sessionKey at runtime too: an untyped JS caller can bypass the\n // Omit above and pass it anyway.\n const { sessionKey: _sessionKey, ...rest } = config as OpenClawLLMConfig;\n\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenClawLLMProvider({\n ...rest,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n return this.provider.generateResponse(messages);\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenClawLLMClient(\n config: OpenClawLLMClientConfig,\n): LLMClient {\n return new OpenClawLLMClient(config);\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/openclaw/provider.ts","../../src/openclaw/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nexport interface OpenClawLLMConfig {\n token: string;\n baseURL?: string;\n /**\n * Target a specific agent on the gateway.\n * When omitted, the gateway's configured default agent handles the request.\n */\n agentId?: string;\n /**\n * Agent target, not a backend model name. The gateway resolves this to an\n * agent: `openclaw`, `openclaw/default`, or `openclaw/<agentId>`.\n *\n * @default \"openclaw/default\"\n */\n model?: string;\n temperature?: number;\n maxTokens?: number;\n /**\n * Pins the conversation to a server-side session on the gateway.\n *\n * The gateway keeps conversation state itself, but without an identifier it\n * opens a fresh session per request: nothing is persisted between turns and\n * each one strands a throwaway session. Sending this as the `user` field makes\n * the gateway derive a stable session key from it.\n *\n * When set, past turns are not resent — the gateway already holds them. The\n * system prompt is still sent every turn so the persona survives a dropped\n * session.\n *\n * Treat it as a conversation-scoped identifier (e.g. a UUID per conversation,\n * rotated when the user resets the chat). Rotating it is the only way to reset\n * the conversation; the gateway keeps the old transcript under the old key.\n */\n sessionKey?: string;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenClawLLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n private sessionKey?: string;\n\n constructor(config: OpenClawLLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenClaw LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.token,\n baseURL: config.baseURL || \"http://127.0.0.1:18789/v1\",\n defaultHeaders: config.agentId\n ? { \"x-openclaw-agent-id\": config.agentId }\n : undefined,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"openclaw/default\";\n this.temperature = config.temperature ?? 0.7;\n this.maxTokens = config.maxTokens || 1000;\n this.sessionKey = config.sessionKey;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = this.selectMessages(messages).map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n });\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: toOpenAIChatMessages(this.selectMessages(messages)),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n ...(openAITools ? { tools: openAITools } : {}),\n });\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n /**\n * With a pinned session the gateway already holds the past turns, and resending\n * them would flatten a duplicate copy of the history on top of its own. Keep the\n * system prompts (cheap persona insurance if the session was dropped) and only\n * what the gateway has not recorded yet:\n * - mid tool round, that is the trailing run of tool results (the gateway\n * generated the assistant tool-call turn that asked for them itself);\n * - otherwise, the latest turn.\n */\n private selectMessages<T extends { role: string }>(messages: T[]): T[] {\n const latest = messages[messages.length - 1];\n if (!this.sessionKey || !latest) {\n return messages;\n }\n\n const systemMessages = messages.filter((msg) => msg.role === \"system\");\n\n if (latest.role === \"tool\") {\n return [...systemMessages, ...trailingToolMessages(messages)];\n }\n\n return latest.role === \"system\"\n ? systemMessages\n : [...systemMessages, latest];\n }\n}\n\n/** The unbroken run of tool results at the end of the conversation. */\nfunction trailingToolMessages<T extends { role: string }>(messages: T[]): T[] {\n let start = messages.length;\n while (start > 0 && messages[start - 1]!.role === \"tool\") {\n start -= 1;\n }\n\n return messages.slice(start);\n}\n\nexport function createOpenClawLLMProvider(\n config: OpenClawLLMConfig,\n): OpenClawLLMProvider {\n return new OpenClawLLMProvider(config);\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenClawLLMProvider,\n OpenClawLLMConfig,\n OpenClawLLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenClawLLMProvider,\n OpenClawLLMProvider,\n type OpenClawLLMConfig,\n} from \"./provider\";\n\n// No `sessionKey` here, unlike the provider config. Pinning the gateway\n// session requires rotating it on reset, and this client is driven by\n// LLMManager, whose clearHistory()/character switch clear only local history and\n// cannot reach the client. A pinned session would survive that reset and silently\n// replay the old conversation. Server routes construct the provider themselves and\n// can rotate the key, so the option lives there instead.\nexport type OpenClawLLMClientConfig = Omit<OpenClawLLMConfig, \"sessionKey\">;\n\n/**\n * OpenClaw LLM Client - Stateless client that wraps the OpenClaw provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The token is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenClawLLMClient implements LLMClient {\n private provider: OpenClawLLMProvider;\n\n constructor(config: OpenClawLLMClientConfig) {\n // Strip sessionKey at runtime too: an untyped JS caller can bypass the\n // Omit above and pass it anyway.\n const { sessionKey: _sessionKey, ...rest } = config as OpenClawLLMConfig;\n\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenClawLLMProvider({\n ...rest,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n return this.provider.generateResponse(messages);\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenClawLLMClient(\n config: OpenClawLLMClientConfig,\n): LLMClient {\n return new OpenClawLLMClient(config);\n}\n"]}
1
+ {"version":3,"sources":["../../src/openclaw/provider.ts","../../src/openclaw/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n LLMProvider,\n toCharivoError,\n type LLMMessage,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\nimport {\n toLLMToolResponse,\n toOpenAIChatMessages,\n toOpenAITools,\n} from \"../openai-tool-format\";\n\nexport interface OpenClawLLMConfig {\n token: string;\n baseURL?: string;\n /**\n * Target a specific agent on the gateway.\n * When omitted, the gateway's configured default agent handles the request.\n */\n agentId?: string;\n /**\n * Agent target, not a backend model name. The gateway resolves this to an\n * agent: `openclaw`, `openclaw/default`, or `openclaw/<agentId>`.\n *\n * @default \"openclaw/default\"\n */\n model?: string;\n temperature?: number;\n maxTokens?: number;\n /**\n * Pins the conversation to a server-side session on the gateway.\n *\n * The gateway keeps conversation state itself, but without an identifier it\n * opens a fresh session per request: nothing is persisted between turns and\n * each one strands a throwaway session. Sending this as the `user` field makes\n * the gateway derive a stable session key from it.\n *\n * When set, past turns are not resent — the gateway already holds them. The\n * system prompt is still sent every turn so the persona survives a dropped\n * session.\n *\n * Treat it as a conversation-scoped identifier (e.g. a UUID per conversation,\n * rotated when the user resets the chat). Rotating it is the only way to reset\n * the conversation; the gateway keeps the old transcript under the old key.\n */\n sessionKey?: string;\n dangerouslyAllowBrowser?: boolean;\n}\n\n/**\n * Deliberately has no request timeout, unlike the OpenAI and Gemini providers.\n * The gateway fronts an agent harness whose runs legitimately take minutes, so\n * any cap short enough to be useful against a hang would also cut off ordinary\n * work. Neither method takes an `AbortSignal`, so a caller can stop waiting on\n * the promise but cannot cancel the run behind it.\n */\nexport class OpenClawLLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n private sessionKey?: string;\n\n constructor(config: OpenClawLLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenClaw LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.token,\n baseURL: config.baseURL || \"http://127.0.0.1:18789/v1\",\n defaultHeaders: config.agentId\n ? { \"x-openclaw-agent-id\": config.agentId }\n : undefined,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"openclaw/default\";\n this.temperature = config.temperature ?? 0.7;\n this.maxTokens = config.maxTokens || 1000;\n this.sessionKey = config.sessionKey;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = this.selectMessages(messages).map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n });\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n async generateResponseWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n try {\n const openAITools = toOpenAITools(tools);\n\n const completion = await this.openai.chat.completions.create({\n model: this.model,\n messages: toOpenAIChatMessages(this.selectMessages(messages)),\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n ...(this.sessionKey ? { user: this.sessionKey } : {}),\n ...(openAITools ? { tools: openAITools } : {}),\n });\n\n return toLLMToolResponse(completion.choices[0]?.message);\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenClaw LLM request failed\");\n }\n }\n\n /**\n * With a pinned session the gateway already holds the past turns, and resending\n * them would flatten a duplicate copy of the history on top of its own. Keep the\n * system prompts (cheap persona insurance if the session was dropped) and only\n * what the gateway has not recorded yet:\n * - mid tool round, that is the trailing run of tool results (the gateway\n * generated the assistant tool-call turn that asked for them itself);\n * - otherwise, the latest turn.\n */\n private selectMessages<T extends { role: string }>(messages: T[]): T[] {\n const latest = messages[messages.length - 1];\n if (!this.sessionKey || !latest) {\n return messages;\n }\n\n const systemMessages = messages.filter((msg) => msg.role === \"system\");\n\n if (latest.role === \"tool\") {\n return [...systemMessages, ...trailingToolMessages(messages)];\n }\n\n return latest.role === \"system\"\n ? systemMessages\n : [...systemMessages, latest];\n }\n}\n\n/** The unbroken run of tool results at the end of the conversation. */\nfunction trailingToolMessages<T extends { role: string }>(messages: T[]): T[] {\n let start = messages.length;\n while (start > 0 && messages[start - 1]!.role === \"tool\") {\n start -= 1;\n }\n\n return messages.slice(start);\n}\n\nexport function createOpenClawLLMProvider(\n config: OpenClawLLMConfig,\n): OpenClawLLMProvider {\n return new OpenClawLLMProvider(config);\n}\n","import type {\n LLMClient,\n LLMMessage,\n LLMToolResponse,\n ToolDefinition,\n} from \"@charivo/core\";\nimport {\n createOpenClawLLMProvider,\n OpenClawLLMConfig,\n OpenClawLLMProvider,\n} from \"./provider\";\n\nexport {\n createOpenClawLLMProvider,\n OpenClawLLMProvider,\n type OpenClawLLMConfig,\n} from \"./provider\";\n\n// No `sessionKey` here, unlike the provider config. Pinning the gateway\n// session requires rotating it on reset, and this client is driven by\n// LLMManager, whose clearHistory()/character switch clear only local history and\n// cannot reach the client. A pinned session would survive that reset and silently\n// replay the old conversation. Server routes construct the provider themselves and\n// can rotate the key, so the option lives there instead.\nexport type OpenClawLLMClientConfig = Omit<OpenClawLLMConfig, \"sessionKey\">;\n\n/**\n * OpenClaw LLM Client - Stateless client that wraps the OpenClaw provider for direct use on the client\n *\n * For use in local development or test environments. Not recommended for production for security reasons.\n * The token is exposed to the client, so use it only in a server environment or for testing purposes.\n *\n * Stateless design: session management is handled externally, and this client only handles API calls\n */\nclass OpenClawLLMClient implements LLMClient {\n private provider: OpenClawLLMProvider;\n\n constructor(config: OpenClawLLMClientConfig) {\n // Strip sessionKey at runtime too: an untyped JS caller can bypass the\n // Omit above and pass it anyway.\n const { sessionKey: _sessionKey, ...rest } = config as OpenClawLLMConfig;\n\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenClawLLMProvider({\n ...rest,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n return this.provider.generateResponse(messages);\n }\n\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse> {\n return this.provider.generateResponseWithTools(messages, tools);\n }\n}\n\nexport function createOpenClawLLMClient(\n config: OpenClawLLMClientConfig,\n): LLMClient {\n return new OpenClawLLMClient(config);\n}\n"]}
@@ -73,16 +73,8 @@ async function postChatRequest(apiEndpoint, body, signal) {
73
73
  // during a slow/streaming response body still cancels the request.
74
74
  async (response) => {
75
75
  if (!response.ok) {
76
- let errorData = { error: "Unknown error" };
77
- try {
78
- errorData = await response.json();
79
- } catch (parseError) {
80
- if (!(parseError instanceof SyntaxError)) {
81
- throw parseError;
82
- }
83
- }
84
76
  throw new core.CharivoProviderError(
85
- `API call failed: ${errorData.error || response.statusText}`
77
+ `API call failed: ${await core.readResponseErrorMessage(response)}`
86
78
  );
87
79
  }
88
80
  return response.json();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/remote/index.ts"],"names":["CharivoProviderError","fetchWithTimeout","DEFAULT_FETCH_TIMEOUT_MS"],"mappings":"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","file":"index.js","sourcesContent":["import {\n CharivoProviderError,\n DEFAULT_FETCH_TIMEOUT_MS,\n fetchWithTimeout,\n type LLMCallOptions,\n type LLMClient,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\n\nexport interface RemoteLLMConfig {\n apiEndpoint?: string;\n}\n\n/** Server reply as received; each field is validated where it is read. */\ninterface RemoteLLMResponseBody {\n success?: boolean;\n error?: string;\n message?: string;\n toolCalls?: unknown;\n}\n\n/**\n * Remote LLM Client - stateless client that calls the server API\n */\nclass RemoteLLMClient implements LLMClient {\n private apiEndpoint: string;\n\n constructor(config: RemoteLLMConfig = {}) {\n this.apiEndpoint = config.apiEndpoint || \"/api/chat\";\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n options?: LLMCallOptions,\n ): Promise<string> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages },\n options?.signal,\n );\n\n if (!data.success) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n return data.message || \"\";\n }\n\n /**\n * Tools are sent as-is, including an empty array: the server is expected to\n * treat an empty list as no tools for that turn.\n */\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n options?: LLMCallOptions,\n ): Promise<LLMToolResponse> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages, tools },\n options?.signal,\n );\n\n // Cast through `unknown` so the guard doesn't narrow `data`'s declared shape\n // away to a bare index signature - the fields below still need their types.\n if (!isPlainObject(data as unknown)) {\n throw new CharivoProviderError(\"Malformed response body\");\n }\n\n // `!== true` keeps the missing/false error path and rejects non-boolean flags.\n if (data.success !== true) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n if (typeof data.message !== \"string\") {\n throw new CharivoProviderError(\n 'LLM response field \"message\" must be a string',\n );\n }\n\n const toolCalls = parseToolCalls(data.toolCalls);\n\n return {\n content: data.message,\n ...(toolCalls ? { toolCalls } : {}),\n };\n }\n}\n\nexport function createRemoteLLMClient(config?: RemoteLLMConfig): LLMClient {\n return new RemoteLLMClient(config);\n}\n\nasync function postChatRequest(\n apiEndpoint: string,\n body: unknown,\n signal?: AbortSignal,\n): Promise<RemoteLLMResponseBody> {\n return fetchWithTimeout(\n apiEndpoint,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n },\n {\n timeoutMessage: `LLM request timed out after ${DEFAULT_FETCH_TIMEOUT_MS}ms`,\n failureMessage: \"LLM request failed\",\n signal,\n },\n // Consume the body while cancellation is still wired up, so an abort\n // during a slow/streaming response body still cancels the request.\n async (response) => {\n if (!response.ok) {\n let errorData: { error?: string } = { error: \"Unknown error\" };\n try {\n errorData = await response.json();\n } catch (parseError) {\n // Only a malformed/non-JSON error body falls back to the default\n // message. Anything else (e.g. an abort or timeout mid-read)\n // propagates as-is so fetchWithTimeout classifies it, instead of\n // masking it behind a generic provider error.\n if (!(parseError instanceof SyntaxError)) {\n throw parseError;\n }\n }\n throw new CharivoProviderError(\n `API call failed: ${errorData.error || response.statusText}`,\n );\n }\n\n return response.json() as Promise<RemoteLLMResponseBody>;\n },\n );\n}\n\nfunction parseToolCalls(value: unknown): LLMToolCall[] | undefined {\n if (value === undefined) {\n return undefined;\n }\n\n if (!Array.isArray(value)) {\n throw new CharivoProviderError(\n 'LLM response field \"toolCalls\" must be an array',\n );\n }\n\n if (value.length === 0) {\n return undefined;\n }\n\n return value.map(parseToolCall);\n}\n\nfunction parseToolCall(value: unknown): LLMToolCall {\n if (!isPlainObject(value)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const { id, name, arguments: args } = value;\n\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"name\"`,\n );\n }\n\n if (!isPlainObject(args)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"arguments\" that are not a JSON object`,\n );\n }\n\n return { id, name, arguments: args };\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}
1
+ {"version":3,"sources":["../../src/remote/index.ts"],"names":["CharivoProviderError","fetchWithTimeout","DEFAULT_FETCH_TIMEOUT_MS","readResponseErrorMessage"],"mappings":"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","file":"index.js","sourcesContent":["import {\n CharivoProviderError,\n DEFAULT_FETCH_TIMEOUT_MS,\n fetchWithTimeout,\n readResponseErrorMessage,\n type LLMCallOptions,\n type LLMClient,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\n\nexport interface RemoteLLMConfig {\n apiEndpoint?: string;\n}\n\n/** Server reply as received; each field is validated where it is read. */\ninterface RemoteLLMResponseBody {\n success?: boolean;\n error?: string;\n message?: string;\n toolCalls?: unknown;\n}\n\n/**\n * Remote LLM Client - stateless client that calls the server API\n */\nclass RemoteLLMClient implements LLMClient {\n private apiEndpoint: string;\n\n constructor(config: RemoteLLMConfig = {}) {\n this.apiEndpoint = config.apiEndpoint || \"/api/chat\";\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n options?: LLMCallOptions,\n ): Promise<string> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages },\n options?.signal,\n );\n\n if (!data.success) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n return data.message || \"\";\n }\n\n /**\n * Tools are sent as-is, including an empty array: the server is expected to\n * treat an empty list as no tools for that turn.\n */\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n options?: LLMCallOptions,\n ): Promise<LLMToolResponse> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages, tools },\n options?.signal,\n );\n\n // Cast through `unknown` so the guard doesn't narrow `data`'s declared shape\n // away to a bare index signature - the fields below still need their types.\n if (!isPlainObject(data as unknown)) {\n throw new CharivoProviderError(\"Malformed response body\");\n }\n\n // `!== true` keeps the missing/false error path and rejects non-boolean flags.\n if (data.success !== true) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n if (typeof data.message !== \"string\") {\n throw new CharivoProviderError(\n 'LLM response field \"message\" must be a string',\n );\n }\n\n const toolCalls = parseToolCalls(data.toolCalls);\n\n return {\n content: data.message,\n ...(toolCalls ? { toolCalls } : {}),\n };\n }\n}\n\nexport function createRemoteLLMClient(config?: RemoteLLMConfig): LLMClient {\n return new RemoteLLMClient(config);\n}\n\nasync function postChatRequest(\n apiEndpoint: string,\n body: unknown,\n signal?: AbortSignal,\n): Promise<RemoteLLMResponseBody> {\n return fetchWithTimeout(\n apiEndpoint,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n },\n {\n timeoutMessage: `LLM request timed out after ${DEFAULT_FETCH_TIMEOUT_MS}ms`,\n failureMessage: \"LLM request failed\",\n signal,\n },\n // Consume the body while cancellation is still wired up, so an abort\n // during a slow/streaming response body still cancels the request.\n async (response) => {\n if (!response.ok) {\n throw new CharivoProviderError(\n `API call failed: ${await readResponseErrorMessage(response)}`,\n );\n }\n\n return response.json() as Promise<RemoteLLMResponseBody>;\n },\n );\n}\n\nfunction parseToolCalls(value: unknown): LLMToolCall[] | undefined {\n if (value === undefined) {\n return undefined;\n }\n\n if (!Array.isArray(value)) {\n throw new CharivoProviderError(\n 'LLM response field \"toolCalls\" must be an array',\n );\n }\n\n if (value.length === 0) {\n return undefined;\n }\n\n return value.map(parseToolCall);\n}\n\nfunction parseToolCall(value: unknown): LLMToolCall {\n if (!isPlainObject(value)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const { id, name, arguments: args } = value;\n\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"name\"`,\n );\n }\n\n if (!isPlainObject(args)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"arguments\" that are not a JSON object`,\n );\n }\n\n return { id, name, arguments: args };\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { CharivoProviderError, fetchWithTimeout, DEFAULT_FETCH_TIMEOUT_MS } from '@charivo/core';
1
+ import { CharivoProviderError, fetchWithTimeout, DEFAULT_FETCH_TIMEOUT_MS, readResponseErrorMessage } from '@charivo/core';
2
2
 
3
3
  // src/remote/index.ts
4
4
  var RemoteLLMClient = class {
@@ -71,16 +71,8 @@ async function postChatRequest(apiEndpoint, body, signal) {
71
71
  // during a slow/streaming response body still cancels the request.
72
72
  async (response) => {
73
73
  if (!response.ok) {
74
- let errorData = { error: "Unknown error" };
75
- try {
76
- errorData = await response.json();
77
- } catch (parseError) {
78
- if (!(parseError instanceof SyntaxError)) {
79
- throw parseError;
80
- }
81
- }
82
74
  throw new CharivoProviderError(
83
- `API call failed: ${errorData.error || response.statusText}`
75
+ `API call failed: ${await readResponseErrorMessage(response)}`
84
76
  );
85
77
  }
86
78
  return response.json();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/remote/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n CharivoProviderError,\n DEFAULT_FETCH_TIMEOUT_MS,\n fetchWithTimeout,\n type LLMCallOptions,\n type LLMClient,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\n\nexport interface RemoteLLMConfig {\n apiEndpoint?: string;\n}\n\n/** Server reply as received; each field is validated where it is read. */\ninterface RemoteLLMResponseBody {\n success?: boolean;\n error?: string;\n message?: string;\n toolCalls?: unknown;\n}\n\n/**\n * Remote LLM Client - stateless client that calls the server API\n */\nclass RemoteLLMClient implements LLMClient {\n private apiEndpoint: string;\n\n constructor(config: RemoteLLMConfig = {}) {\n this.apiEndpoint = config.apiEndpoint || \"/api/chat\";\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n options?: LLMCallOptions,\n ): Promise<string> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages },\n options?.signal,\n );\n\n if (!data.success) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n return data.message || \"\";\n }\n\n /**\n * Tools are sent as-is, including an empty array: the server is expected to\n * treat an empty list as no tools for that turn.\n */\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n options?: LLMCallOptions,\n ): Promise<LLMToolResponse> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages, tools },\n options?.signal,\n );\n\n // Cast through `unknown` so the guard doesn't narrow `data`'s declared shape\n // away to a bare index signature - the fields below still need their types.\n if (!isPlainObject(data as unknown)) {\n throw new CharivoProviderError(\"Malformed response body\");\n }\n\n // `!== true` keeps the missing/false error path and rejects non-boolean flags.\n if (data.success !== true) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n if (typeof data.message !== \"string\") {\n throw new CharivoProviderError(\n 'LLM response field \"message\" must be a string',\n );\n }\n\n const toolCalls = parseToolCalls(data.toolCalls);\n\n return {\n content: data.message,\n ...(toolCalls ? { toolCalls } : {}),\n };\n }\n}\n\nexport function createRemoteLLMClient(config?: RemoteLLMConfig): LLMClient {\n return new RemoteLLMClient(config);\n}\n\nasync function postChatRequest(\n apiEndpoint: string,\n body: unknown,\n signal?: AbortSignal,\n): Promise<RemoteLLMResponseBody> {\n return fetchWithTimeout(\n apiEndpoint,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n },\n {\n timeoutMessage: `LLM request timed out after ${DEFAULT_FETCH_TIMEOUT_MS}ms`,\n failureMessage: \"LLM request failed\",\n signal,\n },\n // Consume the body while cancellation is still wired up, so an abort\n // during a slow/streaming response body still cancels the request.\n async (response) => {\n if (!response.ok) {\n let errorData: { error?: string } = { error: \"Unknown error\" };\n try {\n errorData = await response.json();\n } catch (parseError) {\n // Only a malformed/non-JSON error body falls back to the default\n // message. Anything else (e.g. an abort or timeout mid-read)\n // propagates as-is so fetchWithTimeout classifies it, instead of\n // masking it behind a generic provider error.\n if (!(parseError instanceof SyntaxError)) {\n throw parseError;\n }\n }\n throw new CharivoProviderError(\n `API call failed: ${errorData.error || response.statusText}`,\n );\n }\n\n return response.json() as Promise<RemoteLLMResponseBody>;\n },\n );\n}\n\nfunction parseToolCalls(value: unknown): LLMToolCall[] | undefined {\n if (value === undefined) {\n return undefined;\n }\n\n if (!Array.isArray(value)) {\n throw new CharivoProviderError(\n 'LLM response field \"toolCalls\" must be an array',\n );\n }\n\n if (value.length === 0) {\n return undefined;\n }\n\n return value.map(parseToolCall);\n}\n\nfunction parseToolCall(value: unknown): LLMToolCall {\n if (!isPlainObject(value)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const { id, name, arguments: args } = value;\n\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"name\"`,\n );\n }\n\n if (!isPlainObject(args)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"arguments\" that are not a JSON object`,\n );\n }\n\n return { id, name, arguments: args };\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}
1
+ {"version":3,"sources":["../../src/remote/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n CharivoProviderError,\n DEFAULT_FETCH_TIMEOUT_MS,\n fetchWithTimeout,\n readResponseErrorMessage,\n type LLMCallOptions,\n type LLMClient,\n type LLMMessage,\n type LLMToolCall,\n type LLMToolResponse,\n type ToolDefinition,\n} from \"@charivo/core\";\n\nexport interface RemoteLLMConfig {\n apiEndpoint?: string;\n}\n\n/** Server reply as received; each field is validated where it is read. */\ninterface RemoteLLMResponseBody {\n success?: boolean;\n error?: string;\n message?: string;\n toolCalls?: unknown;\n}\n\n/**\n * Remote LLM Client - stateless client that calls the server API\n */\nclass RemoteLLMClient implements LLMClient {\n private apiEndpoint: string;\n\n constructor(config: RemoteLLMConfig = {}) {\n this.apiEndpoint = config.apiEndpoint || \"/api/chat\";\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n options?: LLMCallOptions,\n ): Promise<string> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages },\n options?.signal,\n );\n\n if (!data.success) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n return data.message || \"\";\n }\n\n /**\n * Tools are sent as-is, including an empty array: the server is expected to\n * treat an empty list as no tools for that turn.\n */\n async callWithTools(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n options?: LLMCallOptions,\n ): Promise<LLMToolResponse> {\n const data = await postChatRequest(\n this.apiEndpoint,\n { messages, tools },\n options?.signal,\n );\n\n // Cast through `unknown` so the guard doesn't narrow `data`'s declared shape\n // away to a bare index signature - the fields below still need their types.\n if (!isPlainObject(data as unknown)) {\n throw new CharivoProviderError(\"Malformed response body\");\n }\n\n // `!== true` keeps the missing/false error path and rejects non-boolean flags.\n if (data.success !== true) {\n throw new CharivoProviderError(\n data.error || \"Failed to generate response\",\n );\n }\n\n if (typeof data.message !== \"string\") {\n throw new CharivoProviderError(\n 'LLM response field \"message\" must be a string',\n );\n }\n\n const toolCalls = parseToolCalls(data.toolCalls);\n\n return {\n content: data.message,\n ...(toolCalls ? { toolCalls } : {}),\n };\n }\n}\n\nexport function createRemoteLLMClient(config?: RemoteLLMConfig): LLMClient {\n return new RemoteLLMClient(config);\n}\n\nasync function postChatRequest(\n apiEndpoint: string,\n body: unknown,\n signal?: AbortSignal,\n): Promise<RemoteLLMResponseBody> {\n return fetchWithTimeout(\n apiEndpoint,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n },\n {\n timeoutMessage: `LLM request timed out after ${DEFAULT_FETCH_TIMEOUT_MS}ms`,\n failureMessage: \"LLM request failed\",\n signal,\n },\n // Consume the body while cancellation is still wired up, so an abort\n // during a slow/streaming response body still cancels the request.\n async (response) => {\n if (!response.ok) {\n throw new CharivoProviderError(\n `API call failed: ${await readResponseErrorMessage(response)}`,\n );\n }\n\n return response.json() as Promise<RemoteLLMResponseBody>;\n },\n );\n}\n\nfunction parseToolCalls(value: unknown): LLMToolCall[] | undefined {\n if (value === undefined) {\n return undefined;\n }\n\n if (!Array.isArray(value)) {\n throw new CharivoProviderError(\n 'LLM response field \"toolCalls\" must be an array',\n );\n }\n\n if (value.length === 0) {\n return undefined;\n }\n\n return value.map(parseToolCall);\n}\n\nfunction parseToolCall(value: unknown): LLMToolCall {\n if (!isPlainObject(value)) {\n throw new CharivoProviderError(\"LLM tool call must be an object\");\n }\n\n const { id, name, arguments: args } = value;\n\n if (typeof id !== \"string\" || id.length === 0) {\n throw new CharivoProviderError(\n 'LLM tool call is missing a non-empty string \"id\"',\n );\n }\n\n if (typeof name !== \"string\" || name.length === 0) {\n throw new CharivoProviderError(\n `LLM tool call \"${id}\" is missing a non-empty string \"name\"`,\n );\n }\n\n if (!isPlainObject(args)) {\n throw new CharivoProviderError(\n `LLM tool call \"${name}\" has \"arguments\" that are not a JSON object`,\n );\n }\n\n return { id, name, arguments: args };\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@charivo/llm",
3
- "version": "0.10.7",
3
+ "version": "0.11.1",
4
4
  "description": "LLM manager and browser adapters for Charivo",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -26,6 +26,11 @@
26
26
  "import": "./dist/openclaw/index.mjs",
27
27
  "require": "./dist/openclaw/index.js"
28
28
  },
29
+ "./gemini": {
30
+ "types": "./dist/gemini/index.d.ts",
31
+ "import": "./dist/gemini/index.mjs",
32
+ "require": "./dist/gemini/index.js"
33
+ },
29
34
  "./stub": {
30
35
  "types": "./dist/stub/index.d.ts",
31
36
  "import": "./dist/stub/index.mjs",
@@ -40,8 +45,8 @@
40
45
  "ai-character"
41
46
  ],
42
47
  "dependencies": {
43
- "openai": "^4.47.1",
44
- "@charivo/core": "^0.33.0"
48
+ "@charivo/core": "^0.34.0",
49
+ "openai": "^4.47.1"
45
50
  },
46
51
  "devDependencies": {
47
52
  "tsup": "^8.5.0",