@charivo/llm 0.11.0 → 0.11.2

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.
@@ -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":";;;;;;;;;;AAcO,SAAS,qBACd,QAAA,EACqC;AACrC,EAAA,OAAO,QAAA,CAAS,GAAA,CAAI,CAAC,OAAA,KAAY;AAC/B,IAAA,QAAQ,QAAQ,IAAA;AAAM,MACpB,KAAK,MAAA;AACH,QAAA,OAAO;AAAA,UACL,IAAA,EAAM,MAAA;AAAA,UACN,cAAc,OAAA,CAAQ,UAAA;AAAA,UACtB,SAAS,OAAA,CAAQ;AAAA,SACnB;AAAA,MACF,KAAK,WAAA;AACH,QAAA,OAAO;AAAA,UACL,IAAA,EAAM,WAAA;AAAA,UACN,SAAS,OAAA,CAAQ,OAAA;AAAA,UACjB,GAAI,OAAA,CAAQ,SAAA,IAAa,OAAA,CAAQ,UAAU,MAAA,GAAS,CAAA,GAChD,EAAE,UAAA,EAAY,QAAQ,SAAA,CAAU,GAAA,CAAI,gBAAgB,CAAA,KACpD;AAAC,SACP;AAAA,MACF,KAAK,QAAA;AAAA,MACL,KAAK,MAAA;AACH,QAAA,OAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,OAAA,EAAS,QAAQ,OAAA,EAAQ;AAAA;AAC1D,EACF,CAAC,CAAA;AACH;AAOO,SAAS,cACd,KAAA,EACyC;AACzC,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAO,KAAA,CAAM,GAAA,CAAI,CAAC,IAAA,MAAU;AAAA,IAC1B,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACR,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,YAAY,IAAA,CAAK;AAAA;AACnB,GACF,CAAE,CAAA;AACJ;AAMO,SAAS,kBACd,OAAA,EACiB;AACjB,EAAA,MAAM,SAAA,GAAY,cAAc,OAAO,CAAA;AAEvC,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,SAAS,OAAA,IAAW,EAAA;AAAA,IAC7B,GAAI,SAAA,CAAU,MAAA,GAAS,IAAI,EAAE,SAAA,KAAc;AAAC,GAC9C;AACF;AAOA,SAAS,cACP,OAAA,EACe;AACf,EAAA,MAAM,eAAe,OAAA,EAAS,UAAA;AAC9B,EAAA,IAAI,CAAC,YAAA,IAAgB,YAAA,CAAa,MAAA,KAAW,CAAA,EAAG;AAC9C,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,OAAO,YAAA,CAAa,IAAI,aAAa,CAAA;AACvC;AAEA,SAAS,iBACP,QAAA,EACsC;AACtC,EAAA,OAAO;AAAA,IACL,IAAI,QAAA,CAAS,EAAA;AAAA,IACb,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACR,MAAM,QAAA,CAAS,IAAA;AAAA,MACf,SAAA,EAAW,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,SAAS;AAAA;AAC9C,GACF;AACF;AAEA,SAAS,cAAc,GAAA,EAAwD;AAC7E,EAAA,IAAI,CAAC,aAAA,CAAc,GAAG,CAAA,EAAG;AACvB,IAAA,MAAM,IAAIA,0BAAqB,iCAAiC,CAAA;AAAA,EAClE;AAEA,EAAA,MAAM,KAAK,GAAA,CAAI,EAAA;AACf,EAAA,IAAI,OAAO,EAAA,KAAO,QAAA,IAAY,EAAA,CAAG,WAAW,CAAA,EAAG;AAC7C,IAAA,MAAM,IAAIA,yBAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,IAAA,GAAO,IAAI,QAAA,EAAU,IAAA;AAC3B,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,WAAW,CAAA,EAAG;AACjD,IAAA,MAAM,IAAIA,yBAAA;AAAA,MACR,kBAAkB,EAAE,CAAA,+CAAA;AAAA,KACtB;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,IAAA;AAAA,IACA,SAAA,EAAW,kBAAA,CAAmB,IAAA,EAAM,GAAA,CAAI,SAAS,SAAS;AAAA,GAC5D;AACF;AAEA,SAAS,kBAAA,CACP,MACA,YAAA,EACyB;AACzB,EAAA,IAAI,MAAA;AAEJ,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,IAAA,CAAK,MAAM,YAAY,CAAA;AAAA,EAClC,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAIA,yBAAA;AAAA,MACR,kBAAkB,IAAI,CAAA,qCAAA,CAAA;AAAA,MACtB,EAAE,KAAA,EAAO,KAAA,YAAiB,KAAA,GAAQ,QAAQ,MAAA;AAAU,KACtD;AAAA,EACF;AAEA,EAAA,IAAI,OAAO,WAAW,QAAA,IAAY,MAAA,KAAW,QAAQ,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC1E,IAAA,MAAM,IAAIA,yBAAA;AAAA,MACR,kBAAkB,IAAI,CAAA,qDAAA;AAAA,KACxB;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,cAAc,KAAA,EAAkD;AACvE,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;;;AC9IA,IAAM,kBAAA,GAAqB,GAAA;AAUpB,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,IAAIC,sBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,uBAAA,CAAO;AAAA,MACvB,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,yBAAyB,MAAA,CAAO;AAAA,KACjC,CAAA;AAED,IAAA,IAAA,CAAK,KAAA,GAAQ,OAAO,KAAA,IAAS,cAAA;AAC7B,IAAA,IAAA,CAAK,WAAA,GAAc,OAAO,WAAA,IAAe,GAAA;AACzC,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,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,WAAA,CAAY,MAAA,CAAO;AAAA,UAClC,OAAO,IAAA,CAAK,KAAA;AAAA,UACZ,QAAA,EAAU,cAAA;AAAA,UACV,aAAa,IAAA,CAAK,WAAA;AAAA,UAClB,YAAY,IAAA,CAAK;AAAA,SAClB,CAAA;AAAA,QACD,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,MAAMC,mBAAA,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,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,WAAA,CAAY,MAAA,CAAO;AAAA,UAClC,OAAO,IAAA,CAAK,KAAA;AAAA,UACZ,QAAA,EAAU,qBAAqB,QAAQ,CAAA;AAAA,UACvC,aAAa,IAAA,CAAK,WAAA;AAAA,UAClB,YAAY,IAAA,CAAK,SAAA;AAAA,UACjB,GAAI,WAAA,GAAc,EAAE,KAAA,EAAO,WAAA,KAAgB;AAAC,SAC7C,CAAA;AAAA,QACD,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,MAAMA,mBAAA,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;AAEA,eAAe,WAAA,CACb,SACA,cAAA,EACY;AACZ,EAAA,IAAI,SAAA;AAEJ,EAAA,MAAM,cAAA,GAAiB,IAAI,OAAA,CAAW,CAAC,GAAG,MAAA,KAAW;AACnD,IAAA,SAAA,GAAY,UAAA;AAAA,MACV,MAAM,MAAA,CAAO,IAAIC,wBAAA,CAAoB,cAAc,CAAC,CAAA;AAAA,MACpD;AAAA,KACF;AAAA,EACF,CAAC,CAAA;AAED,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,OAAA,CAAQ,IAAA,CAAK,CAAC,OAAA,EAAS,cAAc,CAAC,CAAA;AAAA,EACrD,CAAA,SAAE;AACA,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,YAAA,CAAa,SAAS,CAAA;AAAA,IACxB;AAAA,EACF;AACF;;;AChGA,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.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":";;;;AAgBA,IAAM,kBAAA,GAAqB,GAAA;AAUpB,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,yBAAyB,MAAA,CAAO;AAAA,KACjC,CAAA;AAED,IAAA,IAAA,CAAK,KAAA,GAAQ,OAAO,KAAA,IAAS,cAAA;AAC7B,IAAA,IAAA,CAAK,WAAA,GAAc,OAAO,WAAA,IAAe,GAAA;AACzC,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,aAAa,IAAA,CAAK,WAAA;AAAA,YAClB,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,aAAa,IAAA,CAAK,WAAA;AAAA,YAClB,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,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;;;AC/GA,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 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.11.0",
3
+ "version": "0.11.2",
4
4
  "description": "LLM manager and browser adapters for Charivo",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -45,8 +45,8 @@
45
45
  "ai-character"
46
46
  ],
47
47
  "dependencies": {
48
- "openai": "^4.47.1",
49
- "@charivo/core": "^0.33.0"
48
+ "@charivo/core": "^0.35.0",
49
+ "openai": "^4.47.1"
50
50
  },
51
51
  "devDependencies": {
52
52
  "tsup": "^8.5.0",