@almadar/llm 2.14.1 → 2.16.0

package/dist/client.js

@@ -18,8 +18,8 @@ import {
   getSharedLLMClient,
   isProviderAvailable,
   resetSharedLLMClient
-} from "./chunk-AEFJ4WH3.js";
-import "./chunk-LZGCEPHN.js";
+} from "./chunk-ZZO446DL.js";
+import "./chunk-P4VCT25B.js";
 import "./chunk-TGHGQB5I.js";
 export {
   ANTHROPIC_MODELS,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { LLMFinishReason, LLMClient } from './client.js';
-export { ANTHROPIC_MODELS, CacheAwareLLMCallOptions, CacheableBlock, DEEPSEEK_MODELS, KIMI_MODELS, LLMCallOptions, LLMClientOptions, LLMProvider, LLMResponse, LLMStreamChunk, LLMStreamOptions, LLMUsage, OPENAI_MODELS, OPENROUTER_MODELS, ProviderConfig, createAnthropicClient, createCreativeClient, createDeepSeekClient, createFixClient, createKimiClient, createOpenAIClient, createOpenRouterClient, createRequirementsClient, createZhipuClient, getAvailableProvider, getSharedLLMClient, isProviderAvailable, resetSharedLLMClient } from './client.js';
+import { k as LLMFinishReason, i as LLMClient } from './client-DMCU9rVo.js';
+export { A as ANTHROPIC_MODELS, C as CacheAwareLLMCallOptions, a as CacheableBlock, b as ChatCompletionChoice, c as ChatCompletionMessage, d as ChatCompletionResponse, e as ChatCompletionRole, f as ChatCompletionToolCall, g as ChatCompletionToolDef, h as ChatCompletionUsage, D as DEEPSEEK_MODELS, K as KIMI_MODELS, L as LLMCallOptions, j as LLMClientOptions, l as LLMProvider, m as LLMResponse, n as LLMStreamChunk, o as LLMStreamOptions, p as LLMUsage, O as OPENAI_MODELS, q as OPENROUTER_MODELS, P as ProviderConfig, r as createAnthropicClient, s as createCreativeClient, t as createDeepSeekClient, u as createFixClient, v as createKimiClient, w as createOpenAIClient, x as createOpenRouterClient, y as createRequirementsClient, z as createZhipuClient, B as getAvailableProvider, E as getSharedLLMClient, F as isProviderAvailable, G as parseChatCompletionResponse, H as resetSharedLLMClient } from './client-DMCU9rVo.js';
 export { R as RateLimiter, a as RateLimiterOptions, T as TokenTracker, b as TokenUsage, g as getGlobalRateLimiter, c as getGlobalTokenTracker, r as resetGlobalRateLimiter, d as resetGlobalTokenTracker } from './rate-limiter-BqWOhaXY.js';
 export { autoCloseJson, extractJsonFromText, isValidJson, parseJsonResponse, safeParseJson } from './json-parser.js';
 import { z } from 'zod';

package/dist/index.js

@@ -17,22 +17,23 @@ import {
   getAvailableProvider,
   getSharedLLMClient,
   isProviderAvailable,
+  parseChatCompletionResponse,
   resetSharedLLMClient
-} from "./chunk-AEFJ4WH3.js";
+} from "./chunk-ZZO446DL.js";
 import {
   autoCloseJson,
   extractJsonFromText,
   isValidJson,
   parseJsonResponse,
   safeParseJson
-} from "./chunk-LZGCEPHN.js";
+} from "./chunk-P4VCT25B.js";
 import {
   STRUCTURED_OUTPUT_MODELS,
   StructuredOutputClient,
   getStructuredOutputClient,
   isStructuredOutputAvailable,
   resetStructuredOutputClient
-} from "./chunk-5KPNOY62.js";
+} from "./chunk-NO7P6EDT.js";
 import {
   RateLimiter,
   TokenTracker,
@@ -581,6 +582,7 @@ export {
   isStructuredOutputAvailable,
   isValidJson,
   mergeResponses,
+  parseChatCompletionResponse,
   parseJsonResponse,
   resetGlobalRateLimiter,
   resetGlobalTokenTracker,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/embedding-client.ts","../src/truncation-detector.ts","../src/continuation.ts"],"sourcesContent":["/**\n * Embedding Client\n *\n * Single-purpose client for text embeddings. Used by `@almadar-io/agent`'s\n * cosine-similarity catalog retrieval (rank organisms + atoms against the\n * user's request before rendering Stage A's prompt) and by\n * `@almadar/std`'s publish-time embedding bake step.\n *\n * Providers:\n *   - `openai` (default model `text-embedding-3-small`, 1536-d) — requires\n *     `OPENAI_API_KEY`.\n *   - `openrouter` (default model `baai/bge-base-en-v1.5`, 768-d) — requires\n *     `OPEN_ROUTER_API_KEY`. Same OpenAI-compatible request shape, just a\n *     different base URL.\n *\n * Both providers return the same response envelope (`{data:[{embedding,index}]}`),\n * so the request/response code is shared.\n *\n * @packageDocumentation\n */\n\nexport type EmbeddingProvider = 'openai' | 'openrouter';\n\nexport interface EmbeddingClientOptions {\n  provider: EmbeddingProvider;\n  /** Defaults: openai → text-embedding-3-small, openrouter → baai/bge-base-en-v1.5. */\n  model?: string;\n  /** Override API key. Defaults to provider-specific env var. */\n  apiKey?: string;\n  /** Override base URL. Defaults to provider canonical endpoint. */\n  baseUrl?: string;\n}\n\nexport interface EmbeddingUsage {\n  promptTokens: number;\n  totalTokens: number;\n}\n\nexport interface EmbeddingResult {\n  embedding: readonly number[];\n  usage: EmbeddingUsage;\n}\n\nexport interface EmbeddingBatchResult {\n  embeddings: readonly (readonly number[])[];\n  usage: EmbeddingUsage;\n}\n\ninterface OpenAIEmbeddingApiResponse {\n  data: Array<{ embedding: number[]; index: number }>;\n  usage?: { prompt_tokens?: number; total_tokens?: number };\n}\n\nconst DEFAULT_MODELS: Record<EmbeddingProvider, string> = {\n  openai: 'text-embedding-3-small',\n  openrouter: 'baai/bge-base-en-v1.5',\n};\n\nconst DEFAULT_BASE_URLS: Record<EmbeddingProvider, string> = {\n  openai: 'https://api.openai.com/v1',\n  openrouter: 'https://openrouter.ai/api/v1',\n};\n\nconst API_KEY_ENV_VARS: Record<EmbeddingProvider, string> = {\n  openai: 'OPENAI_API_KEY',\n  openrouter: 'OPEN_ROUTER_API_KEY',\n};\n\nexport class EmbeddingClient {\n  private readonly provider: EmbeddingProvider;\n  private readonly model: string;\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(opts: EmbeddingClientOptions) {\n    this.provider = opts.provider;\n    this.model = opts.model ?? DEFAULT_MODELS[opts.provider];\n    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URLS[opts.provider]).replace(/\\/$/, '');\n\n    const apiKey = opts.apiKey ?? this.resolveApiKey();\n    if (!apiKey) {\n      throw new Error(\n        `EmbeddingClient: API key for provider '${this.provider}' not found. ` +\n          `Set ${API_KEY_ENV_VARS[this.provider]} in your environment or pass options.apiKey.`,\n      );\n    }\n    this.apiKey = apiKey;\n  }\n\n  /** Embed a single text. */\n  async embed(text: string): Promise<EmbeddingResult> {\n    const batch = await this.embedBatch([text]);\n    const embedding = batch.embeddings[0];\n    if (!embedding) {\n      throw new Error('EmbeddingClient.embed: provider returned no embedding');\n    }\n    return { embedding, usage: batch.usage };\n  }\n\n  /**\n   * Embed a batch of texts. Used by `@almadar/std`'s publish-time\n   * `build-embeddings.ts` script — one batch call for the full catalog\n   * (≈190 entries) rather than per-entry requests.\n   */\n  async embedBatch(texts: ReadonlyArray<string>): Promise<EmbeddingBatchResult> {\n    if (texts.length === 0) {\n      return { embeddings: [], usage: { promptTokens: 0, totalTokens: 0 } };\n    }\n    const response = await fetch(`${this.baseUrl}/embeddings`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify({ model: this.model, input: texts }),\n    });\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => '<no body>');\n      throw new Error(\n        `EmbeddingClient: ${this.provider} returned ${response.status} ${response.statusText}: ${errorText}`,\n      );\n    }\n    const body = (await response.json()) as OpenAIEmbeddingApiResponse;\n    if (!Array.isArray(body.data)) {\n      throw new Error('EmbeddingClient: provider response missing `data` array');\n    }\n    const ordered = [...body.data].sort((a, b) => a.index - b.index);\n    if (ordered.length !== texts.length) {\n      throw new Error(\n        `EmbeddingClient: provider returned ${ordered.length} embeddings for ${texts.length} inputs`,\n      );\n    }\n    return {\n      embeddings: ordered.map((d) => d.embedding),\n      usage: {\n        promptTokens: body.usage?.prompt_tokens ?? 0,\n        totalTokens: body.usage?.total_tokens ?? 0,\n      },\n    };\n  }\n\n  private resolveApiKey(): string | undefined {\n    return process.env[API_KEY_ENV_VARS[this.provider]];\n  }\n}\n\n/**\n * Cosine similarity between two equal-length vectors. Returns a value in\n * [-1, 1]; higher means more similar. Used by `@almadar-io/agent`'s\n * catalog retrieval to rank organism/atom descriptions against the user\n * request embedding.\n *\n * Defensive: returns 0 when either vector is the zero vector (would\n * otherwise divide by zero).\n */\nexport function cosineSimilarity(a: ReadonlyArray<number>, b: ReadonlyArray<number>): number {\n  if (a.length !== b.length) {\n    throw new Error(`cosineSimilarity: vector length mismatch (${a.length} vs ${b.length})`);\n  }\n  let dot = 0;\n  let normA = 0;\n  let normB = 0;\n  for (let i = 0; i < a.length; i++) {\n    const av = a[i];\n    const bv = b[i];\n    dot += av * bv;\n    normA += av * av;\n    normB += bv * bv;\n  }\n  if (normA === 0 || normB === 0) return 0;\n  return dot / (Math.sqrt(normA) * Math.sqrt(normB));\n}\n","/**\n * Truncation Detector\n *\n * Utilities for detecting when LLM output has been truncated and\n * extracting usable content from partial responses.\n *\n * @packageDocumentation\n */\n\nimport type { LLMFinishReason } from './client.js';\nimport { autoCloseJson } from './json-parser.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type TruncationReason =\n  | 'finish_reason'\n  | 'json_incomplete'\n  | 'bracket_mismatch'\n  | 'none';\n\nexport interface TruncationResult {\n  isTruncated: boolean;\n  reason: TruncationReason;\n  partialContent?: string;\n  lastCompleteElement?: unknown;\n  missingCloseBrackets?: number;\n  missingCloseBraces?: number;\n}\n\n// ============================================================================\n// Main Detection Function\n// ============================================================================\n\n/**\n * Detect if an LLM response has been truncated.\n *\n * Analyzes the response content and finish reason to determine if\n * the output was cut off due to token limits or other issues.\n *\n * @param {string} response - The LLM response text\n * @param {LLMFinishReason} finishReason - The finish reason from the LLM\n * @returns {TruncationResult} Detection result with truncation details\n */\nexport function detectTruncation(\n  response: string,\n  finishReason: LLMFinishReason,\n): TruncationResult {\n  if (finishReason === 'length') {\n    const bracketInfo = countBrackets(response);\n    return {\n      isTruncated: true,\n      reason: 'finish_reason',\n      partialContent: response,\n      lastCompleteElement: findLastCompleteElement(response),\n      missingCloseBrackets: bracketInfo.missingCloseBrackets,\n      missingCloseBraces: bracketInfo.missingCloseBraces,\n    };\n  }\n\n  try {\n    JSON.parse(response);\n    return { isTruncated: false, reason: 'none' };\n  } catch {\n    // JSON is invalid, check if due to truncation\n  }\n\n  if (finishReason === 'stop' || finishReason === null) {\n    const trimmed = response.trim();\n\n    const isMidContent =\n      trimmed.endsWith(',') ||\n      trimmed.endsWith(':') ||\n      trimmed.endsWith('\": ') ||\n      /:\\s*$/.test(trimmed) ||\n      /,\\s*$/.test(trimmed);\n\n    if (isMidContent) {\n      const bracketInfo = countBrackets(response);\n      return {\n        isTruncated: true,\n        reason: 'json_incomplete',\n        partialContent: response,\n        lastCompleteElement: findLastCompleteElement(response),\n        missingCloseBrackets: bracketInfo.missingCloseBrackets,\n        missingCloseBraces: bracketInfo.missingCloseBraces,\n      };\n    }\n\n    try {\n      const closed = autoCloseJson(trimmed);\n      JSON.parse(closed);\n      return { isTruncated: false, reason: 'none' };\n    } catch {\n      return { isTruncated: false, reason: 'none' };\n    }\n  }\n\n  const bracketInfo = countBrackets(response);\n  if (\n    bracketInfo.missingCloseBrackets > 0 ||\n    bracketInfo.missingCloseBraces > 0\n  ) {\n    return {\n      isTruncated: true,\n      reason: 'bracket_mismatch',\n      partialContent: response,\n      lastCompleteElement: findLastCompleteElement(response),\n      missingCloseBrackets: bracketInfo.missingCloseBrackets,\n      missingCloseBraces: bracketInfo.missingCloseBraces,\n    };\n  }\n\n  return { isTruncated: false, reason: 'none' };\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction countBrackets(json: string): {\n  openBrackets: number;\n  closeBrackets: number;\n  openBraces: number;\n  closeBraces: number;\n  missingCloseBrackets: number;\n  missingCloseBraces: number;\n} {\n  let inString = false;\n  let escaped = false;\n  let openBrackets = 0;\n  let closeBrackets = 0;\n  let openBraces = 0;\n  let closeBraces = 0;\n\n  for (const char of json) {\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (char === '\\\\' && inString) {\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n    if (inString) continue;\n\n    switch (char) {\n      case '[':\n        openBrackets++;\n        break;\n      case ']':\n        closeBrackets++;\n        break;\n      case '{':\n        openBraces++;\n        break;\n      case '}':\n        closeBraces++;\n        break;\n    }\n  }\n\n  return {\n    openBrackets,\n    closeBrackets,\n    openBraces,\n    closeBraces,\n    missingCloseBrackets: Math.max(0, openBrackets - closeBrackets),\n    missingCloseBraces: Math.max(0, openBraces - closeBraces),\n  };\n}\n\nexport function findLastCompleteElement(json: string): unknown | null {\n  const autoClosed = autoCloseJson(json);\n  try {\n    return JSON.parse(autoClosed);\n  } catch {\n    // Auto-close didn't work\n  }\n\n  const trimmed = json.trim();\n\n  if (trimmed.startsWith('[')) {\n    const lastCompleteIndex = findLastCompleteArrayElement(trimmed);\n    if (lastCompleteIndex > 0) {\n      const subset = trimmed.substring(0, lastCompleteIndex) + ']';\n      try {\n        return JSON.parse(subset);\n      } catch {\n        // Continue\n      }\n    }\n  }\n\n  if (trimmed.startsWith('{')) {\n    const closed = autoCloseJson(trimmed);\n    try {\n      return JSON.parse(closed);\n    } catch {\n      const lastCompleteIndex = findLastCompleteObjectProperty(trimmed);\n      if (lastCompleteIndex > 0) {\n        const subset = trimmed.substring(0, lastCompleteIndex) + '}';\n        try {\n          return JSON.parse(subset);\n        } catch {\n          // Give up\n        }\n      }\n    }\n  }\n\n  return null;\n}\n\nfunction findLastCompleteArrayElement(json: string): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n  let lastCompleteElementEnd = -1;\n\n  for (let i = 0; i < json.length; i++) {\n    const char = json[i];\n\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (char === '\\\\' && inString) {\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n    if (inString) continue;\n\n    if (char === '[' || char === '{') {\n      depth++;\n    } else if (char === ']' || char === '}') {\n      depth--;\n      if (depth === 1) {\n        lastCompleteElementEnd = i + 1;\n      }\n    } else if (char === ',' && depth === 1) {\n      lastCompleteElementEnd = i;\n    }\n  }\n\n  return lastCompleteElementEnd > 0 ? lastCompleteElementEnd : -1;\n}\n\nfunction findLastCompleteObjectProperty(json: string): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n  let lastCommaIndex = -1;\n\n  for (let i = 0; i < json.length; i++) {\n    const char = json[i];\n\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (char === '\\\\' && inString) {\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n    if (inString) continue;\n\n    if (char === '[' || char === '{') {\n      depth++;\n    } else if (char === ']' || char === '}') {\n      depth--;\n    } else if (char === ',' && depth === 1) {\n      lastCommaIndex = i;\n    }\n  }\n\n  return lastCommaIndex > 0 ? lastCommaIndex : -1;\n}\n\nexport function isLikelyTruncated(content: string): boolean {\n  const trimmed = content.trim();\n  if (!trimmed) return false;\n\n  const brackets = countBrackets(trimmed);\n  if (\n    brackets.missingCloseBrackets > 0 ||\n    brackets.missingCloseBraces > 0\n  ) {\n    return true;\n  }\n\n  const abruptEndings = [\n    /,\\s*$/,\n    /:\\s*$/,\n    /\"\\s*:\\s*$/,\n    /\\[\\s*$/,\n    /{\\s*$/,\n  ];\n\n  for (const pattern of abruptEndings) {\n    if (pattern.test(trimmed)) return true;\n  }\n\n  return false;\n}\n","/**\n * LLM Continuation Utility\n *\n * Handles truncated LLM responses with automatic continuation.\n * - Detects truncation via finish_reason and JSON structure\n * - Automatically continues with full context\n * - Merges partial and continuation responses\n * - Salvages partial data if max continuations reached\n *\n * @packageDocumentation\n */\n\nimport { z } from 'zod';\nimport { LLMClient, type LLMFinishReason } from './client.js';\nimport { detectTruncation } from './truncation-detector.js';\nimport { extractJsonFromText, autoCloseJson, isValidJson } from './json-parser.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ContinuationOptions<T> {\n  client: LLMClient;\n  systemPrompt: string;\n  userPrompt: string;\n  schema?: z.ZodSchema<T>;\n  maxTokens?: number;\n  maxContinuations?: number;\n  maxRetries?: number;\n  buildContinuationPrompt: (\n    partialResponse: string,\n    attempt: number,\n  ) => string;\n  continuationSystemPrompt?: string;\n}\n\nexport interface ContinuationResult<T> {\n  data: T;\n  raw: string;\n  continuationCount: number;\n  warnings: string[];\n  wasSalvaged: boolean;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst DEFAULT_MAX_TOKENS = 8192;\nconst DEFAULT_MAX_CONTINUATIONS = 3;\n\n/**\n * Default continuation system prompt.\n * Used when no custom continuationSystemPrompt is provided.\n */\nconst DEFAULT_CONTINUATION_SYSTEM_PROMPT = `You are a JSON continuation assistant. Your ONLY job is to continue generating JSON from where the previous response was truncated.\n\nRules:\n1. Continue from EXACTLY where the previous output stopped\n2. Do NOT repeat any content already generated\n3. Complete the JSON structure properly with all closing brackets\n4. Do NOT wrap in markdown code blocks\n5. Output ONLY the continuation JSON, nothing else`;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Merge a previous partial response with a continuation.\n *\n * Handles JSON structure merging, removing markdown code blocks,\n * and ensuring proper comma separation between merged parts.\n *\n * @param {string} previous - The previous partial response\n * @param {string} continuation - The continuation to merge\n * @returns {string} The merged response\n */\nexport function mergeResponses(\n  previous: string,\n  continuation: string,\n): string {\n  const trimmedPrev = previous.trimEnd();\n  const trimmedCont = continuation.trimStart();\n\n  let cleanedCont = trimmedCont\n    .replace(/^```json?\\s*/i, '')\n    .replace(/```\\s*$/i, '')\n    .trim();\n\n  if (cleanedCont.startsWith('{')) {\n    try {\n      const contParsed = JSON.parse(autoCloseJson(cleanedCont));\n      const keys = Object.keys(contParsed);\n      if (keys.length === 1 && Array.isArray(contParsed[keys[0]])) {\n        cleanedCont = contParsed[keys[0]]\n          .map((item: unknown) => JSON.stringify(item))\n          .join(',\\n');\n      }\n    } catch {\n      // Continue with original cleaning\n    }\n  }\n\n  if (cleanedCont.startsWith('}') || cleanedCont.startsWith(']')) {\n    return trimmedPrev + cleanedCont;\n  }\n\n  const prevEndsWithValue = /[\\}\\]\\\"\\d]$/.test(trimmedPrev);\n  const contStartsWithValue = /^[\\{\\[\\\"]/.test(cleanedCont);\n\n  if (prevEndsWithValue && contStartsWithValue) {\n    return trimmedPrev + ',\\n' + cleanedCont;\n  }\n\n  return trimmedPrev + cleanedCont;\n}\n\nexport function salvagePartialResponse<T>(rawResponse: string): T | null {\n  console.warn('[Continuation] Attempting to salvage partial response');\n\n  try {\n    const cleanedResponse = extractJsonFromText(rawResponse) || rawResponse;\n    const closed = autoCloseJson(cleanedResponse);\n    const parsed = JSON.parse(closed) as T;\n    console.log('[Continuation] Successfully salvaged partial response');\n    return parsed;\n  } catch (error) {\n    console.error('[Continuation] Could not salvage response:', error);\n  }\n\n  return null;\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Call an LLM with automatic continuation handling.\n *\n * Manages token limits by detecting truncation and making continuation\n * calls until the complete response is received or max continuations reached.\n *\n * @template T - Expected response type\n * @param {ContinuationOptions<T>} options - Continuation call options\n * @returns {Promise<ContinuationResult<T>>} Result with data and continuation metadata\n */\nexport async function callWithContinuation<T>(\n  options: ContinuationOptions<T>,\n): Promise<ContinuationResult<T>> {\n  const {\n    client,\n    systemPrompt,\n    userPrompt,\n    schema,\n    maxTokens = DEFAULT_MAX_TOKENS,\n    maxContinuations = DEFAULT_MAX_CONTINUATIONS,\n    buildContinuationPrompt,\n    continuationSystemPrompt = DEFAULT_CONTINUATION_SYSTEM_PROMPT,\n  } = options;\n\n  let rawResponse = '';\n  let continuationCount = 0;\n  const warnings: string[] = [];\n  let wasSalvaged = false;\n\n  console.log('[Continuation] Starting LLM call with continuation support');\n  console.log(\n    `[Continuation] Max tokens: ${maxTokens}, Max continuations: ${maxContinuations}`,\n  );\n\n  try {\n    const response = await client.callRawWithMetadata({\n      systemPrompt,\n      userPrompt,\n      maxTokens,\n    });\n\n    rawResponse = extractJsonFromText(response.raw) || response.raw;\n\n    console.log(\n      `[Continuation] Initial response: ${rawResponse.length} chars, finish_reason: ${response.finishReason}`,\n    );\n\n    let truncation = detectTruncation(rawResponse, response.finishReason);\n\n    while (truncation.isTruncated && continuationCount < maxContinuations) {\n      continuationCount++;\n      const warningMsg = `Response truncated (${truncation.reason}), continuing (attempt ${continuationCount}/${maxContinuations})`;\n      console.log(`[Continuation] ${warningMsg}`);\n      warnings.push(warningMsg);\n\n      const contPrompt = buildContinuationPrompt(\n        rawResponse,\n        continuationCount,\n      );\n\n      const contResponse = await client.callRawWithMetadata({\n        systemPrompt: continuationSystemPrompt,\n        userPrompt: contPrompt,\n        maxTokens,\n      });\n\n      console.log(\n        `[Continuation] Continuation response: ${contResponse.raw.length} chars, finish_reason: ${contResponse.finishReason}`,\n      );\n\n      const cleanedContResponse =\n        extractJsonFromText(contResponse.raw) || contResponse.raw;\n      rawResponse = mergeResponses(rawResponse, cleanedContResponse);\n\n      truncation = detectTruncation(rawResponse, contResponse.finishReason);\n    }\n\n    if (\n      continuationCount >= maxContinuations &&\n      truncation.isTruncated\n    ) {\n      console.warn(\n        `[Continuation] Reached max continuations (${maxContinuations}), attempting to salvage...`,\n      );\n      warnings.push(\n        `Reached max continuations - some content may be incomplete`,\n      );\n      wasSalvaged = true;\n    }\n\n    const cleanedResponse =\n      extractJsonFromText(rawResponse) || rawResponse;\n    let data: T;\n\n    try {\n      if (isValidJson(cleanedResponse)) {\n        data = JSON.parse(cleanedResponse) as T;\n      } else {\n        const closed = autoCloseJson(cleanedResponse);\n        data = JSON.parse(closed) as T;\n        if (!wasSalvaged) {\n          warnings.push('Response required auto-closing of JSON brackets');\n        }\n      }\n    } catch (parseError) {\n      const salvaged = salvagePartialResponse<T>(cleanedResponse);\n      if (salvaged) {\n        data = salvaged;\n        wasSalvaged = true;\n        warnings.push('Response was salvaged from partial data');\n      } else {\n        throw new Error(\n          `Failed to parse response after ${continuationCount} continuations: ${parseError}`,\n        );\n      }\n    }\n\n    if (schema) {\n      try {\n        data = schema.parse(data);\n      } catch (validationError) {\n        console.warn(\n          '[Continuation] Schema validation failed:',\n          validationError,\n        );\n        warnings.push(`Schema validation issue: ${validationError}`);\n      }\n    }\n\n    console.log(\n      `[Continuation] Complete. Continuations: ${continuationCount}, Warnings: ${warnings.length}`,\n    );\n\n    return {\n      data,\n      raw: rawResponse,\n      continuationCount,\n      warnings,\n      wasSalvaged,\n    };\n  } catch (error) {\n    console.error('[Continuation] Error during LLM call:', error);\n    throw error;\n  }\n}\n\n/**\n * Build a generic continuation prompt.\n *\n * Creates a prompt that instructs the LLM to continue from where\n * a previous truncated response left off.\n *\n * @param {string} context - Original context/prompt\n * @param {string} partialResponse - The partial response generated so far\n * @param {number} attempt - Current continuation attempt number\n * @param {number} [maxAttempts] - Maximum allowed continuation attempts\n * @returns {string} The formatted continuation prompt\n */\nexport function buildGenericContinuationPrompt(\n  context: string,\n  partialResponse: string,\n  attempt: number,\n  maxAttempts: number = DEFAULT_MAX_CONTINUATIONS,\n): string {\n  return `## CONTINUATION REQUEST (Attempt ${attempt}/${maxAttempts})\n\nYour previous response was truncated. Continue generating from where you left off.\n\n### ORIGINAL CONTEXT\n${context}\n\n### WHAT YOU GENERATED SO FAR\n\\`\\`\\`json\n${partialResponse}\n\\`\\`\\`\n\n### INSTRUCTIONS\n1. Continue from EXACTLY where the response was cut off\n2. Do NOT repeat any content already generated\n3. Complete the JSON structure properly\n4. Do NOT wrap your response in markdown code blocks\n\nContinue generating now:`;\n}\n"],"mappings":"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","names":["bracketInfo"]}
+{"version":3,"sources":["../src/embedding-client.ts","../src/truncation-detector.ts","../src/continuation.ts"],"sourcesContent":["/**\n * Embedding Client\n *\n * Single-purpose client for text embeddings. Used by `@almadar-io/agent`'s\n * cosine-similarity catalog retrieval (rank organisms + atoms against the\n * user's request before rendering Stage A's prompt) and by\n * `@almadar/std`'s publish-time embedding bake step.\n *\n * Providers:\n *   - `openai` (default model `text-embedding-3-small`, 1536-d) — requires\n *     `OPENAI_API_KEY`.\n *   - `openrouter` (default model `baai/bge-base-en-v1.5`, 768-d) — requires\n *     `OPEN_ROUTER_API_KEY`. Same OpenAI-compatible request shape, just a\n *     different base URL.\n *\n * Both providers return the same response envelope (`{data:[{embedding,index}]}`),\n * so the request/response code is shared.\n *\n * @packageDocumentation\n */\n\nexport type EmbeddingProvider = 'openai' | 'openrouter';\n\nexport interface EmbeddingClientOptions {\n  provider: EmbeddingProvider;\n  /** Defaults: openai → text-embedding-3-small, openrouter → baai/bge-base-en-v1.5. */\n  model?: string;\n  /** Override API key. Defaults to provider-specific env var. */\n  apiKey?: string;\n  /** Override base URL. Defaults to provider canonical endpoint. */\n  baseUrl?: string;\n}\n\nexport interface EmbeddingUsage {\n  promptTokens: number;\n  totalTokens: number;\n}\n\nexport interface EmbeddingResult {\n  embedding: readonly number[];\n  usage: EmbeddingUsage;\n}\n\nexport interface EmbeddingBatchResult {\n  embeddings: readonly (readonly number[])[];\n  usage: EmbeddingUsage;\n}\n\ninterface OpenAIEmbeddingApiResponse {\n  data: Array<{ embedding: number[]; index: number }>;\n  usage?: { prompt_tokens?: number; total_tokens?: number };\n}\n\nconst DEFAULT_MODELS: Record<EmbeddingProvider, string> = {\n  openai: 'text-embedding-3-small',\n  openrouter: 'baai/bge-base-en-v1.5',\n};\n\nconst DEFAULT_BASE_URLS: Record<EmbeddingProvider, string> = {\n  openai: 'https://api.openai.com/v1',\n  openrouter: 'https://openrouter.ai/api/v1',\n};\n\nconst API_KEY_ENV_VARS: Record<EmbeddingProvider, string> = {\n  openai: 'OPENAI_API_KEY',\n  openrouter: 'OPEN_ROUTER_API_KEY',\n};\n\nexport class EmbeddingClient {\n  private readonly provider: EmbeddingProvider;\n  private readonly model: string;\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(opts: EmbeddingClientOptions) {\n    this.provider = opts.provider;\n    this.model = opts.model ?? DEFAULT_MODELS[opts.provider];\n    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URLS[opts.provider]).replace(/\\/$/, '');\n\n    const apiKey = opts.apiKey ?? this.resolveApiKey();\n    if (!apiKey) {\n      throw new Error(\n        `EmbeddingClient: API key for provider '${this.provider}' not found. ` +\n          `Set ${API_KEY_ENV_VARS[this.provider]} in your environment or pass options.apiKey.`,\n      );\n    }\n    this.apiKey = apiKey;\n  }\n\n  /** Embed a single text. */\n  async embed(text: string): Promise<EmbeddingResult> {\n    const batch = await this.embedBatch([text]);\n    const embedding = batch.embeddings[0];\n    if (!embedding) {\n      throw new Error('EmbeddingClient.embed: provider returned no embedding');\n    }\n    return { embedding, usage: batch.usage };\n  }\n\n  /**\n   * Embed a batch of texts. Used by `@almadar/std`'s publish-time\n   * `build-embeddings.ts` script — one batch call for the full catalog\n   * (≈190 entries) rather than per-entry requests.\n   */\n  async embedBatch(texts: ReadonlyArray<string>): Promise<EmbeddingBatchResult> {\n    if (texts.length === 0) {\n      return { embeddings: [], usage: { promptTokens: 0, totalTokens: 0 } };\n    }\n    const response = await fetch(`${this.baseUrl}/embeddings`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify({ model: this.model, input: texts }),\n    });\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => '<no body>');\n      throw new Error(\n        `EmbeddingClient: ${this.provider} returned ${response.status} ${response.statusText}: ${errorText}`,\n      );\n    }\n    const body = (await response.json()) as OpenAIEmbeddingApiResponse;\n    if (!Array.isArray(body.data)) {\n      throw new Error('EmbeddingClient: provider response missing `data` array');\n    }\n    const ordered = [...body.data].sort((a, b) => a.index - b.index);\n    if (ordered.length !== texts.length) {\n      throw new Error(\n        `EmbeddingClient: provider returned ${ordered.length} embeddings for ${texts.length} inputs`,\n      );\n    }\n    return {\n      embeddings: ordered.map((d) => d.embedding),\n      usage: {\n        promptTokens: body.usage?.prompt_tokens ?? 0,\n        totalTokens: body.usage?.total_tokens ?? 0,\n      },\n    };\n  }\n\n  private resolveApiKey(): string | undefined {\n    return process.env[API_KEY_ENV_VARS[this.provider]];\n  }\n}\n\n/**\n * Cosine similarity between two equal-length vectors. Returns a value in\n * [-1, 1]; higher means more similar. Used by `@almadar-io/agent`'s\n * catalog retrieval to rank organism/atom descriptions against the user\n * request embedding.\n *\n * Defensive: returns 0 when either vector is the zero vector (would\n * otherwise divide by zero).\n */\nexport function cosineSimilarity(a: ReadonlyArray<number>, b: ReadonlyArray<number>): number {\n  if (a.length !== b.length) {\n    throw new Error(`cosineSimilarity: vector length mismatch (${a.length} vs ${b.length})`);\n  }\n  let dot = 0;\n  let normA = 0;\n  let normB = 0;\n  for (let i = 0; i < a.length; i++) {\n    const av = a[i];\n    const bv = b[i];\n    dot += av * bv;\n    normA += av * av;\n    normB += bv * bv;\n  }\n  if (normA === 0 || normB === 0) return 0;\n  return dot / (Math.sqrt(normA) * Math.sqrt(normB));\n}\n","/**\n * Truncation Detector\n *\n * Utilities for detecting when LLM output has been truncated and\n * extracting usable content from partial responses.\n *\n * @packageDocumentation\n */\n\nimport type { LLMFinishReason } from './client.js';\nimport { autoCloseJson } from './json-parser.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type TruncationReason =\n  | 'finish_reason'\n  | 'json_incomplete'\n  | 'bracket_mismatch'\n  | 'none';\n\nexport interface TruncationResult {\n  isTruncated: boolean;\n  reason: TruncationReason;\n  partialContent?: string;\n  lastCompleteElement?: unknown;\n  missingCloseBrackets?: number;\n  missingCloseBraces?: number;\n}\n\n// ============================================================================\n// Main Detection Function\n// ============================================================================\n\n/**\n * Detect if an LLM response has been truncated.\n *\n * Analyzes the response content and finish reason to determine if\n * the output was cut off due to token limits or other issues.\n *\n * @param {string} response - The LLM response text\n * @param {LLMFinishReason} finishReason - The finish reason from the LLM\n * @returns {TruncationResult} Detection result with truncation details\n */\nexport function detectTruncation(\n  response: string,\n  finishReason: LLMFinishReason,\n): TruncationResult {\n  if (finishReason === 'length') {\n    const bracketInfo = countBrackets(response);\n    return {\n      isTruncated: true,\n      reason: 'finish_reason',\n      partialContent: response,\n      lastCompleteElement: findLastCompleteElement(response),\n      missingCloseBrackets: bracketInfo.missingCloseBrackets,\n      missingCloseBraces: bracketInfo.missingCloseBraces,\n    };\n  }\n\n  try {\n    JSON.parse(response);\n    return { isTruncated: false, reason: 'none' };\n  } catch {\n    // JSON is invalid, check if due to truncation\n  }\n\n  if (finishReason === 'stop' || finishReason === null) {\n    const trimmed = response.trim();\n\n    const isMidContent =\n      trimmed.endsWith(',') ||\n      trimmed.endsWith(':') ||\n      trimmed.endsWith('\": ') ||\n      /:\\s*$/.test(trimmed) ||\n      /,\\s*$/.test(trimmed);\n\n    if (isMidContent) {\n      const bracketInfo = countBrackets(response);\n      return {\n        isTruncated: true,\n        reason: 'json_incomplete',\n        partialContent: response,\n        lastCompleteElement: findLastCompleteElement(response),\n        missingCloseBrackets: bracketInfo.missingCloseBrackets,\n        missingCloseBraces: bracketInfo.missingCloseBraces,\n      };\n    }\n\n    try {\n      const closed = autoCloseJson(trimmed);\n      JSON.parse(closed);\n      return { isTruncated: false, reason: 'none' };\n    } catch {\n      return { isTruncated: false, reason: 'none' };\n    }\n  }\n\n  const bracketInfo = countBrackets(response);\n  if (\n    bracketInfo.missingCloseBrackets > 0 ||\n    bracketInfo.missingCloseBraces > 0\n  ) {\n    return {\n      isTruncated: true,\n      reason: 'bracket_mismatch',\n      partialContent: response,\n      lastCompleteElement: findLastCompleteElement(response),\n      missingCloseBrackets: bracketInfo.missingCloseBrackets,\n      missingCloseBraces: bracketInfo.missingCloseBraces,\n    };\n  }\n\n  return { isTruncated: false, reason: 'none' };\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction countBrackets(json: string): {\n  openBrackets: number;\n  closeBrackets: number;\n  openBraces: number;\n  closeBraces: number;\n  missingCloseBrackets: number;\n  missingCloseBraces: number;\n} {\n  let inString = false;\n  let escaped = false;\n  let openBrackets = 0;\n  let closeBrackets = 0;\n  let openBraces = 0;\n  let closeBraces = 0;\n\n  for (const char of json) {\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (char === '\\\\' && inString) {\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n    if (inString) continue;\n\n    switch (char) {\n      case '[':\n        openBrackets++;\n        break;\n      case ']':\n        closeBrackets++;\n        break;\n      case '{':\n        openBraces++;\n        break;\n      case '}':\n        closeBraces++;\n        break;\n    }\n  }\n\n  return {\n    openBrackets,\n    closeBrackets,\n    openBraces,\n    closeBraces,\n    missingCloseBrackets: Math.max(0, openBrackets - closeBrackets),\n    missingCloseBraces: Math.max(0, openBraces - closeBraces),\n  };\n}\n\nexport function findLastCompleteElement(json: string): unknown | null {\n  const autoClosed = autoCloseJson(json);\n  try {\n    return JSON.parse(autoClosed);\n  } catch {\n    // Auto-close didn't work\n  }\n\n  const trimmed = json.trim();\n\n  if (trimmed.startsWith('[')) {\n    const lastCompleteIndex = findLastCompleteArrayElement(trimmed);\n    if (lastCompleteIndex > 0) {\n      const subset = trimmed.substring(0, lastCompleteIndex) + ']';\n      try {\n        return JSON.parse(subset);\n      } catch {\n        // Continue\n      }\n    }\n  }\n\n  if (trimmed.startsWith('{')) {\n    const closed = autoCloseJson(trimmed);\n    try {\n      return JSON.parse(closed);\n    } catch {\n      const lastCompleteIndex = findLastCompleteObjectProperty(trimmed);\n      if (lastCompleteIndex > 0) {\n        const subset = trimmed.substring(0, lastCompleteIndex) + '}';\n        try {\n          return JSON.parse(subset);\n        } catch {\n          // Give up\n        }\n      }\n    }\n  }\n\n  return null;\n}\n\nfunction findLastCompleteArrayElement(json: string): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n  let lastCompleteElementEnd = -1;\n\n  for (let i = 0; i < json.length; i++) {\n    const char = json[i];\n\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (char === '\\\\' && inString) {\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n    if (inString) continue;\n\n    if (char === '[' || char === '{') {\n      depth++;\n    } else if (char === ']' || char === '}') {\n      depth--;\n      if (depth === 1) {\n        lastCompleteElementEnd = i + 1;\n      }\n    } else if (char === ',' && depth === 1) {\n      lastCompleteElementEnd = i;\n    }\n  }\n\n  return lastCompleteElementEnd > 0 ? lastCompleteElementEnd : -1;\n}\n\nfunction findLastCompleteObjectProperty(json: string): number {\n  let depth = 0;\n  let inString = false;\n  let escaped = false;\n  let lastCommaIndex = -1;\n\n  for (let i = 0; i < json.length; i++) {\n    const char = json[i];\n\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (char === '\\\\' && inString) {\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inString = !inString;\n      continue;\n    }\n    if (inString) continue;\n\n    if (char === '[' || char === '{') {\n      depth++;\n    } else if (char === ']' || char === '}') {\n      depth--;\n    } else if (char === ',' && depth === 1) {\n      lastCommaIndex = i;\n    }\n  }\n\n  return lastCommaIndex > 0 ? lastCommaIndex : -1;\n}\n\nexport function isLikelyTruncated(content: string): boolean {\n  const trimmed = content.trim();\n  if (!trimmed) return false;\n\n  const brackets = countBrackets(trimmed);\n  if (\n    brackets.missingCloseBrackets > 0 ||\n    brackets.missingCloseBraces > 0\n  ) {\n    return true;\n  }\n\n  const abruptEndings = [\n    /,\\s*$/,\n    /:\\s*$/,\n    /\"\\s*:\\s*$/,\n    /\\[\\s*$/,\n    /{\\s*$/,\n  ];\n\n  for (const pattern of abruptEndings) {\n    if (pattern.test(trimmed)) return true;\n  }\n\n  return false;\n}\n","/**\n * LLM Continuation Utility\n *\n * Handles truncated LLM responses with automatic continuation.\n * - Detects truncation via finish_reason and JSON structure\n * - Automatically continues with full context\n * - Merges partial and continuation responses\n * - Salvages partial data if max continuations reached\n *\n * @packageDocumentation\n */\n\nimport { z } from 'zod';\nimport { LLMClient, type LLMFinishReason } from './client.js';\nimport { detectTruncation } from './truncation-detector.js';\nimport { extractJsonFromText, autoCloseJson, isValidJson } from './json-parser.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ContinuationOptions<T> {\n  client: LLMClient;\n  systemPrompt: string;\n  userPrompt: string;\n  schema?: z.ZodSchema<T>;\n  maxTokens?: number;\n  maxContinuations?: number;\n  maxRetries?: number;\n  buildContinuationPrompt: (\n    partialResponse: string,\n    attempt: number,\n  ) => string;\n  continuationSystemPrompt?: string;\n}\n\nexport interface ContinuationResult<T> {\n  data: T;\n  raw: string;\n  continuationCount: number;\n  warnings: string[];\n  wasSalvaged: boolean;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst DEFAULT_MAX_TOKENS = 8192;\nconst DEFAULT_MAX_CONTINUATIONS = 3;\n\n/**\n * Default continuation system prompt.\n * Used when no custom continuationSystemPrompt is provided.\n */\nconst DEFAULT_CONTINUATION_SYSTEM_PROMPT = `You are a JSON continuation assistant. Your ONLY job is to continue generating JSON from where the previous response was truncated.\n\nRules:\n1. Continue from EXACTLY where the previous output stopped\n2. Do NOT repeat any content already generated\n3. Complete the JSON structure properly with all closing brackets\n4. Do NOT wrap in markdown code blocks\n5. Output ONLY the continuation JSON, nothing else`;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Merge a previous partial response with a continuation.\n *\n * Handles JSON structure merging, removing markdown code blocks,\n * and ensuring proper comma separation between merged parts.\n *\n * @param {string} previous - The previous partial response\n * @param {string} continuation - The continuation to merge\n * @returns {string} The merged response\n */\nexport function mergeResponses(\n  previous: string,\n  continuation: string,\n): string {\n  const trimmedPrev = previous.trimEnd();\n  const trimmedCont = continuation.trimStart();\n\n  let cleanedCont = trimmedCont\n    .replace(/^```json?\\s*/i, '')\n    .replace(/```\\s*$/i, '')\n    .trim();\n\n  if (cleanedCont.startsWith('{')) {\n    try {\n      const contParsed = JSON.parse(autoCloseJson(cleanedCont));\n      const keys = Object.keys(contParsed);\n      if (keys.length === 1 && Array.isArray(contParsed[keys[0]])) {\n        cleanedCont = contParsed[keys[0]]\n          .map((item: unknown) => JSON.stringify(item))\n          .join(',\\n');\n      }\n    } catch {\n      // Continue with original cleaning\n    }\n  }\n\n  if (cleanedCont.startsWith('}') || cleanedCont.startsWith(']')) {\n    return trimmedPrev + cleanedCont;\n  }\n\n  const prevEndsWithValue = /[\\}\\]\\\"\\d]$/.test(trimmedPrev);\n  const contStartsWithValue = /^[\\{\\[\\\"]/.test(cleanedCont);\n\n  if (prevEndsWithValue && contStartsWithValue) {\n    return trimmedPrev + ',\\n' + cleanedCont;\n  }\n\n  return trimmedPrev + cleanedCont;\n}\n\nexport function salvagePartialResponse<T>(rawResponse: string): T | null {\n  console.warn('[Continuation] Attempting to salvage partial response');\n\n  try {\n    const cleanedResponse = extractJsonFromText(rawResponse) || rawResponse;\n    const closed = autoCloseJson(cleanedResponse);\n    const parsed = JSON.parse(closed) as T;\n    console.log('[Continuation] Successfully salvaged partial response');\n    return parsed;\n  } catch (error) {\n    console.error('[Continuation] Could not salvage response:', error);\n  }\n\n  return null;\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Call an LLM with automatic continuation handling.\n *\n * Manages token limits by detecting truncation and making continuation\n * calls until the complete response is received or max continuations reached.\n *\n * @template T - Expected response type\n * @param {ContinuationOptions<T>} options - Continuation call options\n * @returns {Promise<ContinuationResult<T>>} Result with data and continuation metadata\n */\nexport async function callWithContinuation<T>(\n  options: ContinuationOptions<T>,\n): Promise<ContinuationResult<T>> {\n  const {\n    client,\n    systemPrompt,\n    userPrompt,\n    schema,\n    maxTokens = DEFAULT_MAX_TOKENS,\n    maxContinuations = DEFAULT_MAX_CONTINUATIONS,\n    buildContinuationPrompt,\n    continuationSystemPrompt = DEFAULT_CONTINUATION_SYSTEM_PROMPT,\n  } = options;\n\n  let rawResponse = '';\n  let continuationCount = 0;\n  const warnings: string[] = [];\n  let wasSalvaged = false;\n\n  console.log('[Continuation] Starting LLM call with continuation support');\n  console.log(\n    `[Continuation] Max tokens: ${maxTokens}, Max continuations: ${maxContinuations}`,\n  );\n\n  try {\n    const response = await client.callRawWithMetadata({\n      systemPrompt,\n      userPrompt,\n      maxTokens,\n    });\n\n    rawResponse = extractJsonFromText(response.raw) || response.raw;\n\n    console.log(\n      `[Continuation] Initial response: ${rawResponse.length} chars, finish_reason: ${response.finishReason}`,\n    );\n\n    let truncation = detectTruncation(rawResponse, response.finishReason);\n\n    while (truncation.isTruncated && continuationCount < maxContinuations) {\n      continuationCount++;\n      const warningMsg = `Response truncated (${truncation.reason}), continuing (attempt ${continuationCount}/${maxContinuations})`;\n      console.log(`[Continuation] ${warningMsg}`);\n      warnings.push(warningMsg);\n\n      const contPrompt = buildContinuationPrompt(\n        rawResponse,\n        continuationCount,\n      );\n\n      const contResponse = await client.callRawWithMetadata({\n        systemPrompt: continuationSystemPrompt,\n        userPrompt: contPrompt,\n        maxTokens,\n      });\n\n      console.log(\n        `[Continuation] Continuation response: ${contResponse.raw.length} chars, finish_reason: ${contResponse.finishReason}`,\n      );\n\n      const cleanedContResponse =\n        extractJsonFromText(contResponse.raw) || contResponse.raw;\n      rawResponse = mergeResponses(rawResponse, cleanedContResponse);\n\n      truncation = detectTruncation(rawResponse, contResponse.finishReason);\n    }\n\n    if (\n      continuationCount >= maxContinuations &&\n      truncation.isTruncated\n    ) {\n      console.warn(\n        `[Continuation] Reached max continuations (${maxContinuations}), attempting to salvage...`,\n      );\n      warnings.push(\n        `Reached max continuations - some content may be incomplete`,\n      );\n      wasSalvaged = true;\n    }\n\n    const cleanedResponse =\n      extractJsonFromText(rawResponse) || rawResponse;\n    let data: T;\n\n    try {\n      if (isValidJson(cleanedResponse)) {\n        data = JSON.parse(cleanedResponse) as T;\n      } else {\n        const closed = autoCloseJson(cleanedResponse);\n        data = JSON.parse(closed) as T;\n        if (!wasSalvaged) {\n          warnings.push('Response required auto-closing of JSON brackets');\n        }\n      }\n    } catch (parseError) {\n      const salvaged = salvagePartialResponse<T>(cleanedResponse);\n      if (salvaged) {\n        data = salvaged;\n        wasSalvaged = true;\n        warnings.push('Response was salvaged from partial data');\n      } else {\n        throw new Error(\n          `Failed to parse response after ${continuationCount} continuations: ${parseError}`,\n        );\n      }\n    }\n\n    if (schema) {\n      try {\n        data = schema.parse(data);\n      } catch (validationError) {\n        console.warn(\n          '[Continuation] Schema validation failed:',\n          validationError,\n        );\n        warnings.push(`Schema validation issue: ${validationError}`);\n      }\n    }\n\n    console.log(\n      `[Continuation] Complete. Continuations: ${continuationCount}, Warnings: ${warnings.length}`,\n    );\n\n    return {\n      data,\n      raw: rawResponse,\n      continuationCount,\n      warnings,\n      wasSalvaged,\n    };\n  } catch (error) {\n    console.error('[Continuation] Error during LLM call:', error);\n    throw error;\n  }\n}\n\n/**\n * Build a generic continuation prompt.\n *\n * Creates a prompt that instructs the LLM to continue from where\n * a previous truncated response left off.\n *\n * @param {string} context - Original context/prompt\n * @param {string} partialResponse - The partial response generated so far\n * @param {number} attempt - Current continuation attempt number\n * @param {number} [maxAttempts] - Maximum allowed continuation attempts\n * @returns {string} The formatted continuation prompt\n */\nexport function buildGenericContinuationPrompt(\n  context: string,\n  partialResponse: string,\n  attempt: number,\n  maxAttempts: number = DEFAULT_MAX_CONTINUATIONS,\n): string {\n  return `## CONTINUATION REQUEST (Attempt ${attempt}/${maxAttempts})\n\nYour previous response was truncated. Continue generating from where you left off.\n\n### ORIGINAL CONTEXT\n${context}\n\n### WHAT YOU GENERATED SO FAR\n\\`\\`\\`json\n${partialResponse}\n\\`\\`\\`\n\n### INSTRUCTIONS\n1. Continue from EXACTLY where the response was cut off\n2. Do NOT repeat any content already generated\n3. Complete the JSON structure properly\n4. Do NOT wrap your response in markdown code blocks\n\nContinue generating now:`;\n}\n"],"mappings":"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","names":["bracketInfo"]}

package/dist/json-parser.js

@@ -4,7 +4,7 @@ import {
   isValidJson,
   parseJsonResponse,
   safeParseJson
-} from "./chunk-LZGCEPHN.js";
+} from "./chunk-P4VCT25B.js";
 export {
   autoCloseJson,
   extractJsonFromText,

package/dist/structured-output.d.ts

@@ -74,7 +74,7 @@ interface StructuredGenerationResult<T = unknown> {
     /** Zod validation result (if not skipped) */
     zodValidation?: {
         success: boolean;
-        errors?: z.ZodError['errors'];
+        errors?: z.ZodError['issues'];
     };
 }
 declare const STRUCTURED_OUTPUT_MODELS: {

package/dist/structured-output.js

@@ -4,7 +4,7 @@ import {
   getStructuredOutputClient,
   isStructuredOutputAvailable,
   resetStructuredOutputClient
-} from "./chunk-5KPNOY62.js";
+} from "./chunk-NO7P6EDT.js";
 import "./chunk-TGHGQB5I.js";
 export {
   STRUCTURED_OUTPUT_MODELS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/llm",
-  "version": "2.14.1",
+  "version": "2.16.0",
   "description": "Multi-provider LLM client with rate limiting, token tracking, structured outputs, and continuation handling",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,15 +40,10 @@
     "zod": "^3.22.0"
   },
   "peerDependencies": {
-    "@almadar/core": ">=7.12.0"
-  },
-  "peerDependenciesMeta": {
-    "@almadar/core": {
-      "optional": true
-    }
+    "@almadar/core": ">=8.5.0"
   },
   "devDependencies": {
-    "@almadar/core": "^7.12.0",
+    "@almadar/core": "^8.5.1",
     "@almadar/eslint-plugin": ">=2.3.0",
     "@types/node": "^22.0.0",
     "@typescript-eslint/parser": "8.56.0",

package/src/client.ts

@@ -23,6 +23,11 @@ import {
 } from './rate-limiter.js';
 import { TokenTracker, getGlobalTokenTracker } from './token-tracker.js';
 import { parseJsonResponse } from './json-parser.js';
+import {
+  parseChatCompletionResponse,
+  type ChatCompletionMessage,
+  type ChatCompletionToolDef,
+} from './tool-call-types.js';
 
 // ============================================================================
 // Local type helpers (avoid Record<string, unknown> and unsafe casts)
@@ -894,6 +899,115 @@ export class LLMClient {
     });
   }
 
+  /**
+   * Tool-calling chat-completion call that speaks the OpenAI wire format
+   * directly via `fetch`, bypassing LangChain's `ChatOpenAI` converter.
+   *
+   * MOTIVATION: LangChain's `convertMessagesToCompletionsMessageParams`
+   * silently drops every `additional_kwargs` field except `function_call`
+   * and `tool_calls`. DeepSeek V4 thinking-mode requires
+   * `reasoning_content` to be echoed back on assistant turns that
+   * triggered tool_calls; LangChain's converter strips it, the next
+   * round-trip fails with "400 The reasoning_content in the thinking
+   * mode must be passed back to the API." This method preserves every
+   * assistant field verbatim across round-trips.
+   *
+   * Supported providers: any OpenAI-compatible endpoint (openai,
+   * deepseek, openrouter, kimi, orbgen). Anthropic uses a different
+   * wire format and is intentionally not supported here — use
+   * `callWithMessages` for Anthropic.
+   *
+   * Defaults `parallel_tool_calls: false` — sequential tool dispatch is
+   * the protocol-safe baseline. Multi-tool-call assistant messages
+   * trigger DeepSeek's "insufficient tool messages" 400 error.
+   */
+  async callWithTools(options: {
+    messages: ReadonlyArray<ChatCompletionMessage>;
+    tools: ReadonlyArray<ChatCompletionToolDef>;
+    maxTokens?: number;
+    parallelToolCalls?: boolean;
+    signal?: AbortSignal;
+  }): Promise<{
+    message: ChatCompletionMessage;
+    finishReason: string;
+    usage: LLMUsage | null;
+  }> {
+    if (this.provider === 'anthropic') {
+      throw new Error(
+        'LLMClient.callWithTools: anthropic provider is not supported; use callWithMessages instead',
+      );
+    }
+    return this.rateLimiter.execute(async () => {
+      const baseUrl = (this.providerConfig.baseUrl ?? 'https://api.openai.com/v1').replace(/\/$/, '');
+      const url = `${baseUrl}/chat/completions`;
+
+      const body: { [key: string]: unknown } = {
+        model: this.modelName,
+        messages: options.messages,
+        parallel_tool_calls: options.parallelToolCalls ?? false,
+        temperature: this.temperature,
+      };
+      if (options.tools.length > 0) body['tools'] = options.tools;
+      if (options.maxTokens !== undefined) body['max_tokens'] = options.maxTokens;
+
+      const startedAt = Date.now();
+      console.log(
+        `[LLMClient:callWithTools] Invoking ${this.provider}/${this.modelName} (tools=${options.tools.length}, messages=${options.messages.length})`,
+      );
+
+      const fetchInit: RequestInit = {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Authorization: `Bearer ${this.providerConfig.apiKey}`,
+        },
+        body: JSON.stringify(body),
+      };
+      if (options.signal) fetchInit.signal = options.signal;
+      const response = await fetch(url, fetchInit);
+
+      if (!response.ok) {
+        const errText = await response.text().catch(() => '<no body>');
+        const elapsed = Date.now() - startedAt;
+        console.error(
+          `[LLMClient:callWithTools] FAILED after ${elapsed}ms (${response.status} ${response.statusText}): ${errText}`,
+        );
+        throw new Error(
+          `LLMClient.callWithTools: ${this.provider} returned ${response.status} ${response.statusText}: ${errText}`,
+        );
+      }
+
+      const raw = await response.text();
+      const parsed = parseChatCompletionResponse(raw);
+      const choice = parsed.choices[0];
+      if (!choice) {
+        throw new Error('LLMClient.callWithTools: no choices in response');
+      }
+
+      let usage: LLMUsage | null = null;
+      if (parsed.usage) {
+        usage = {
+          promptTokens: parsed.usage.prompt_tokens,
+          completionTokens: parsed.usage.completion_tokens,
+          totalTokens: parsed.usage.total_tokens,
+        };
+        if (this.tokenTracker) {
+          this.tokenTracker.addUsage(usage.promptTokens, usage.completionTokens);
+        }
+      }
+
+      console.log(
+        `[LLMClient:callWithTools] Responded in ${Date.now() - startedAt}ms (prompt=${usage?.promptTokens ?? 0}, completion=${usage?.completionTokens ?? 0}, tool_calls=${choice.message.tool_calls?.length ?? 0})`,
+      );
+
+      return {
+        message: choice.message,
+        finishReason: choice.finish_reason,
+        usage,
+      };
+    });
+  }
+
   /**
    * Stream a raw text response as an async iterator of content chunks.
    * Uses the underlying LangChain model's .stream() method.

package/src/index.ts

@@ -54,6 +54,17 @@ export {
   type TokenUsage,
 } from './token-tracker.js';
 
+export {
+  parseChatCompletionResponse,
+  type ChatCompletionRole,
+  type ChatCompletionToolCall,
+  type ChatCompletionMessage,
+  type ChatCompletionToolDef,
+  type ChatCompletionChoice,
+  type ChatCompletionUsage,
+  type ChatCompletionResponse,
+} from './tool-call-types.js';
+
 export {
   EmbeddingClient,
   cosineSimilarity,

package/src/json-parser.ts

@@ -150,7 +150,7 @@ export function parseJsonResponse<T>(
   if (schema) {
     const result = schema.safeParse(parsed);
     if (!result.success) {
-      const errors = result.error.errors
+      const errors = result.error.issues
         .map((e) => `${e.path.join('.')}: ${e.message}`)
         .join('; ');
       throw new Error(`Schema validation failed: ${errors}`);

package/src/structured-output.ts

@@ -101,7 +101,7 @@ export interface StructuredGenerationResult<T = unknown> {
   /** Zod validation result (if not skipped) */
   zodValidation?: {
     success: boolean;
-    errors?: z.ZodError['errors'];
+    errors?: z.ZodError['issues'];
   };
 }
 

package/src/tool-call-types.ts

@@ -0,0 +1,126 @@
+/**
+ * OpenAI Chat Completions wire-format types used by `LLMClient.callWithTools`.
+ *
+ * These mirror the public OpenAI Chat Completions API spec, which is also
+ * the protocol every OpenAI-compatible provider (DeepSeek, OpenRouter,
+ * Kimi, OrbGen, etc.) implements. The types are intentionally faithful
+ * to the wire format — when the LLM emits a `reasoning_content` field
+ * (DeepSeek V4 thinking mode), it's preserved verbatim and echoed back
+ * on the next round-trip.
+ */
+
+import type { JsonSchema } from '@almadar/core';
+
+// ============================================================================
+// Tool definitions sent to the API
+// ============================================================================
+
+export interface ChatCompletionToolDef {
+  type: 'function';
+  function: {
+    name: string;
+    description: string;
+    /** JSON Schema describing the tool's parameters. Sent verbatim to the
+     *  provider as the tool-call `function.parameters` field. */
+    parameters: JsonSchema;
+  };
+}
+
+// ============================================================================
+// Message shape (used in both request and response)
+// ============================================================================
+
+export type ChatCompletionRole = 'system' | 'user' | 'assistant' | 'tool';
+
+export interface ChatCompletionToolCall {
+  id: string;
+  type: 'function';
+  function: { name: string; arguments: string };
+}
+
+export interface ChatCompletionMessage {
+  role: ChatCompletionRole;
+  /** Null is valid (assistant-only) when the message exists purely to carry `tool_calls`. */
+  content: string | null;
+  /** Present on assistant turns that called one or more tools. */
+  tool_calls?: ChatCompletionToolCall[];
+  /** Present on tool-role messages — matches `tool_calls[*].id` of the preceding assistant turn. */
+  tool_call_id?: string;
+  /**
+   * DeepSeek V4 thinking-mode chain-of-thought string. Must be echoed
+   * back on the next round-trip when the assistant turn triggered
+   * tool_calls — that's the protocol contract that LangChain's
+   * ChatOpenAI converter breaks.
+   */
+  reasoning_content?: string;
+}
+
+// ============================================================================
+// Response shape
+// ============================================================================
+
+export interface ChatCompletionChoice {
+  index: number;
+  message: ChatCompletionMessage;
+  finish_reason: string;
+}
+
+export interface ChatCompletionUsage {
+  prompt_tokens: number;
+  completion_tokens: number;
+  total_tokens: number;
+}
+
+export interface ChatCompletionResponse {
+  choices: ChatCompletionChoice[];
+  usage?: ChatCompletionUsage;
+}
+
+// ============================================================================
+// Response parsing — strict type narrowing without `as unknown as`
+// ============================================================================
+
+export function parseChatCompletionResponse(raw: string): ChatCompletionResponse {
+  let json: unknown;
+  try {
+    json = JSON.parse(raw);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `parseChatCompletionResponse: not valid JSON (${reason}): ${raw.slice(0, 400)}`,
+    );
+  }
+  if (!isChatCompletionResponse(json)) {
+    throw new Error(
+      `parseChatCompletionResponse: response did not match expected shape: ${raw.slice(0, 400)}`,
+    );
+  }
+  return json;
+}
+
+function isChatCompletionResponse(value: unknown): value is ChatCompletionResponse {
+  if (value === null || typeof value !== 'object') return false;
+  const obj = value as { choices?: unknown };
+  if (!Array.isArray(obj.choices)) return false;
+  for (const c of obj.choices) {
+    if (!isChatCompletionChoice(c)) return false;
+  }
+  return true;
+}
+
+function isChatCompletionChoice(value: unknown): value is ChatCompletionChoice {
+  if (value === null || typeof value !== 'object') return false;
+  const c = value as { message?: unknown; finish_reason?: unknown; index?: unknown };
+  if (typeof c.finish_reason !== 'string') return false;
+  if (typeof c.index !== 'number') return false;
+  if (!isChatCompletionMessage(c.message)) return false;
+  return true;
+}
+
+function isChatCompletionMessage(value: unknown): value is ChatCompletionMessage {
+  if (value === null || typeof value !== 'object') return false;
+  const m = value as { role?: unknown; content?: unknown };
+  if (typeof m.role !== 'string') return false;
+  if (m.content !== null && typeof m.content !== 'string') return false;
+  return true;
+}