@almadar/llm 2.1.0 → 2.2.0

package/dist/chunk-QOOSH67G.js

@@ -0,0 +1,133 @@
+// src/providers/masar.ts
+var MasarError = class extends Error {
+  constructor(message, statusCode, responseBody) {
+    super(message);
+    this.statusCode = statusCode;
+    this.responseBody = responseBody;
+    this.name = "MasarError";
+  }
+};
+var DEFAULT_BASE_URL = "https://masar-345008351456.europe-west4.run.app";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var MasarProvider = class {
+  constructor(options) {
+    this.baseUrl = (options?.baseUrl ?? process.env.MASAR_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  }
+  // --------------------------------------------------------------------------
+  // Public API
+  // --------------------------------------------------------------------------
+  /**
+   * Generate text from a prompt.
+   *
+   * POST /generate
+   */
+  async generate(prompt, options) {
+    return this.post("/generate", {
+      prompt,
+      ...options
+    });
+  }
+  /**
+   * Generate a .orb schema via GFlowNet sampling.
+   *
+   * POST /generate/gflownet
+   */
+  async generateGFlowNet(goal) {
+    return this.post("/generate/gflownet", goal);
+  }
+  /**
+   * Predict validation errors in a .orb schema before compilation.
+   *
+   * POST /predict-errors
+   */
+  async predictErrors(schema) {
+    return this.post("/predict-errors", { schema });
+  }
+  /**
+   * Rank candidate edits for fixing errors in a .orb schema.
+   *
+   * POST /rank-edits
+   */
+  async rankEdits(schema, errors) {
+    return this.post("/rank-edits", { schema, errors });
+  }
+  /**
+   * Check server health.
+   *
+   * GET /health
+   */
+  async health() {
+    return this.get("/health");
+  }
+  // --------------------------------------------------------------------------
+  // Internal helpers
+  // --------------------------------------------------------------------------
+  async post(path, body) {
+    return this.request(path, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+  }
+  async get(path) {
+    return this.request(path, { method: "GET" });
+  }
+  async request(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await fetch(url, {
+        ...init,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new MasarError(
+          `Masar ${init.method} ${path} failed with status ${response.status}`,
+          response.status,
+          text
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof MasarError) {
+        throw error;
+      }
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new MasarError(
+          `Masar ${init.method} ${path} timed out after ${this.timeoutMs}ms`,
+          0,
+          ""
+        );
+      }
+      const message = error instanceof Error ? error.message : String(error);
+      throw new MasarError(
+        `Masar ${init.method} ${path} failed: ${message}`,
+        0,
+        ""
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+var sharedInstance = null;
+function getMasarProvider(options) {
+  if (!sharedInstance) {
+    sharedInstance = new MasarProvider(options);
+  }
+  return sharedInstance;
+}
+function resetMasarProvider() {
+  sharedInstance = null;
+}
+
+export {
+  MasarError,
+  MasarProvider,
+  getMasarProvider,
+  resetMasarProvider
+};
+//# sourceMappingURL=chunk-QOOSH67G.js.map

package/dist/chunk-QOOSH67G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/masar.ts"],"sourcesContent":["/**\n * Masar Provider\n *\n * Thin HTTP client for the Masar neural pipeline server.\n * Exposes generate, GFlowNet generation, error prediction,\n * edit ranking, and health-check endpoints.\n *\n * Reads `MASAR_URL` from environment (default: http://localhost:8080).\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface MasarGenerateOptions {\n  /** Model override (server decides default if omitted). */\n  model?: string;\n  /** Sampling temperature. */\n  temperature?: number;\n  /** Maximum tokens to generate. */\n  maxTokens?: number;\n}\n\nexport interface MasarGenerateResult {\n  text: string;\n  usage: {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n  };\n}\n\nexport interface GoalSpec {\n  /** Natural-language description of the desired application. */\n  description: string;\n  /** Target entities (e.g. [\"User\", \"Product\", \"Order\"]). */\n  entities?: string[];\n  /** Domain hint (e.g. \"e-commerce\", \"healthcare\"). */\n  domain?: string;\n  /** Additional constraints passed to the GFlowNet sampler. */\n  constraints?: Record<string, unknown>;\n}\n\nexport interface GFlowNetResult {\n  /** Generated .orb schema text. */\n  schema: string;\n  /** Log-probability of the sampled trajectory. */\n  logProb: number;\n  /** Number of sampling steps taken. */\n  steps: number;\n}\n\nexport interface ErrorPrediction {\n  /** Line number (1-based) where the error is predicted. */\n  line: number;\n  /** Predicted error category. */\n  category: string;\n  /** Human-readable description. */\n  message: string;\n  /** Confidence score in [0, 1]. */\n  confidence: number;\n}\n\nexport interface PredictErrorsResult {\n  errors: ErrorPrediction[];\n}\n\nexport interface RankedEdit {\n  /** The proposed replacement text. */\n  edit: string;\n  /** Score assigned by the ranker (higher is better). */\n  score: number;\n  /** Which error this edit addresses. */\n  targetError: string;\n}\n\nexport interface RankEditsResult {\n  edits: RankedEdit[];\n}\n\nexport interface MasarHealthResult {\n  status: string;\n  version?: string;\n  uptime?: number;\n}\n\nexport interface MasarProviderOptions {\n  /** Base URL of the Masar server. Overrides MASAR_URL env var. */\n  baseUrl?: string;\n  /** Request timeout in milliseconds (default: 30 000). */\n  timeoutMs?: number;\n}\n\n// ============================================================================\n// Error\n// ============================================================================\n\nexport class MasarError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly responseBody: string,\n  ) {\n    super(message);\n    this.name = 'MasarError';\n  }\n}\n\n// ============================================================================\n// Provider\n// ============================================================================\n\nconst DEFAULT_BASE_URL = 'https://masar-345008351456.europe-west4.run.app';\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\nexport class MasarProvider {\n  private readonly baseUrl: string;\n  private readonly timeoutMs: number;\n\n  constructor(options?: MasarProviderOptions) {\n    this.baseUrl = (\n      options?.baseUrl ??\n      process.env.MASAR_URL ??\n      DEFAULT_BASE_URL\n    ).replace(/\\/+$/, '');\n    this.timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  }\n\n  // --------------------------------------------------------------------------\n  // Public API\n  // --------------------------------------------------------------------------\n\n  /**\n   * Generate text from a prompt.\n   *\n   * POST /generate\n   */\n  async generate(\n    prompt: string,\n    options?: MasarGenerateOptions,\n  ): Promise<MasarGenerateResult> {\n    return this.post<MasarGenerateResult>('/generate', {\n      prompt,\n      ...options,\n    });\n  }\n\n  /**\n   * Generate a .orb schema via GFlowNet sampling.\n   *\n   * POST /generate/gflownet\n   */\n  async generateGFlowNet(goal: GoalSpec): Promise<GFlowNetResult> {\n    return this.post<GFlowNetResult>('/generate/gflownet', goal);\n  }\n\n  /**\n   * Predict validation errors in a .orb schema before compilation.\n   *\n   * POST /predict-errors\n   */\n  async predictErrors(schema: string): Promise<PredictErrorsResult> {\n    return this.post<PredictErrorsResult>('/predict-errors', { schema });\n  }\n\n  /**\n   * Rank candidate edits for fixing errors in a .orb schema.\n   *\n   * POST /rank-edits\n   */\n  async rankEdits(\n    schema: string,\n    errors: string[],\n  ): Promise<RankEditsResult> {\n    return this.post<RankEditsResult>('/rank-edits', { schema, errors });\n  }\n\n  /**\n   * Check server health.\n   *\n   * GET /health\n   */\n  async health(): Promise<MasarHealthResult> {\n    return this.get<MasarHealthResult>('/health');\n  }\n\n  // --------------------------------------------------------------------------\n  // Internal helpers\n  // --------------------------------------------------------------------------\n\n  private async post<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(path, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(body),\n    });\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    return this.request<T>(path, { method: 'GET' });\n  }\n\n  private async request<T>(\n    path: string,\n    init: RequestInit,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const text = await response.text().catch(() => '');\n        throw new MasarError(\n          `Masar ${init.method} ${path} failed with status ${response.status}`,\n          response.status,\n          text,\n        );\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof MasarError) {\n        throw error;\n      }\n\n      if (error instanceof DOMException && error.name === 'AbortError') {\n        throw new MasarError(\n          `Masar ${init.method} ${path} timed out after ${this.timeoutMs}ms`,\n          0,\n          '',\n        );\n      }\n\n      const message =\n        error instanceof Error ? error.message : String(error);\n      throw new MasarError(\n        `Masar ${init.method} ${path} failed: ${message}`,\n        0,\n        '',\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\n// ============================================================================\n// Singleton\n// ============================================================================\n\nlet sharedInstance: MasarProvider | null = null;\n\nexport function getMasarProvider(\n  options?: MasarProviderOptions,\n): MasarProvider {\n  if (!sharedInstance) {\n    sharedInstance = new MasarProvider(options);\n  }\n  return sharedInstance;\n}\n\nexport function resetMasarProvider(): void {\n  sharedInstance = null;\n}\n"],"mappings":"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","names":[]}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { a as RateLimiterOptions, b as TokenUsage } from './rate-limiter-9XAWfHwe.js';
+import { R as RateLimiterOptions, T as TokenUsage } from './rate-limiter-DDH7JH5p.js';
 import { ChatOpenAI } from '@langchain/openai';
 import { ChatAnthropic } from '@langchain/anthropic';
 import { z } from 'zod';

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 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, getAvailableProvider, getSharedLLMClient, isProviderAvailable, resetSharedLLMClient } from './client.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-9XAWfHwe.js';
+export { a as RateLimiter, R as RateLimiterOptions, b as TokenTracker, T as TokenUsage, g as getGlobalRateLimiter, c as getGlobalTokenTracker, r as resetGlobalRateLimiter, d as resetGlobalTokenTracker } from './rate-limiter-DDH7JH5p.js';
 export { autoCloseJson, extractJsonFromText, isValidJson, parseJsonResponse, safeParseJson } from './json-parser.js';
 import { z } from 'zod';
 export { JsonSchema, STRUCTURED_OUTPUT_MODELS, StructuredGenerationOptions, StructuredGenerationResult, StructuredOutputClient, StructuredOutputOptions, getStructuredOutputClient, isStructuredOutputAvailable, resetStructuredOutputClient } from './structured-output.js';
 import { ServiceContract } from '@almadar/core';
+export { ErrorPrediction, GFlowNetResult, GoalSpec, MasarError, MasarGenerateOptions, MasarGenerateResult, MasarHealthResult, MasarProvider, MasarProviderOptions, PredictErrorsResult, RankEditsResult, RankedEdit, getMasarProvider, resetMasarProvider } from './providers/index.js';
 import '@langchain/openai';
 import '@langchain/anthropic';
 

package/dist/index.js

@@ -40,6 +40,12 @@ import {
   resetGlobalRateLimiter,
   resetGlobalTokenTracker
 } from "./chunk-MJS33AAS.js";
+import {
+  MasarError,
+  MasarProvider,
+  getMasarProvider,
+  resetMasarProvider
+} from "./chunk-QOOSH67G.js";
 
 // src/truncation-detector.ts
 function detectTruncation(response, finishReason) {
@@ -440,6 +446,8 @@ export {
   DEEPSEEK_MODELS,
   KIMI_MODELS,
   LLMClient,
+  MasarError,
+  MasarProvider,
   OPENAI_MODELS,
   OPENROUTER_MODELS,
   RateLimiter,
@@ -463,6 +471,7 @@ export {
   getAvailableProvider,
   getGlobalRateLimiter,
   getGlobalTokenTracker,
+  getMasarProvider,
   getSharedLLMClient,
   getStructuredOutputClient,
   isLikelyTruncated,
@@ -473,6 +482,7 @@ export {
   parseJsonResponse,
   resetGlobalRateLimiter,
   resetGlobalTokenTracker,
+  resetMasarProvider,
   resetSharedLLMClient,
   resetStructuredOutputClient,
   safeParseJson,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/truncation-detector.ts","../src/continuation.ts"],"sourcesContent":["/**\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\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\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\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\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/truncation-detector.ts","../src/continuation.ts"],"sourcesContent":["/**\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\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\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\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\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/providers/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Masar Provider
+ *
+ * Thin HTTP client for the Masar neural pipeline server.
+ * Exposes generate, GFlowNet generation, error prediction,
+ * edit ranking, and health-check endpoints.
+ *
+ * Reads `MASAR_URL` from environment (default: http://localhost:8080).
+ *
+ * @packageDocumentation
+ */
+interface MasarGenerateOptions {
+    /** Model override (server decides default if omitted). */
+    model?: string;
+    /** Sampling temperature. */
+    temperature?: number;
+    /** Maximum tokens to generate. */
+    maxTokens?: number;
+}
+interface MasarGenerateResult {
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+interface GoalSpec {
+    /** Natural-language description of the desired application. */
+    description: string;
+    /** Target entities (e.g. ["User", "Product", "Order"]). */
+    entities?: string[];
+    /** Domain hint (e.g. "e-commerce", "healthcare"). */
+    domain?: string;
+    /** Additional constraints passed to the GFlowNet sampler. */
+    constraints?: Record<string, unknown>;
+}
+interface GFlowNetResult {
+    /** Generated .orb schema text. */
+    schema: string;
+    /** Log-probability of the sampled trajectory. */
+    logProb: number;
+    /** Number of sampling steps taken. */
+    steps: number;
+}
+interface ErrorPrediction {
+    /** Line number (1-based) where the error is predicted. */
+    line: number;
+    /** Predicted error category. */
+    category: string;
+    /** Human-readable description. */
+    message: string;
+    /** Confidence score in [0, 1]. */
+    confidence: number;
+}
+interface PredictErrorsResult {
+    errors: ErrorPrediction[];
+}
+interface RankedEdit {
+    /** The proposed replacement text. */
+    edit: string;
+    /** Score assigned by the ranker (higher is better). */
+    score: number;
+    /** Which error this edit addresses. */
+    targetError: string;
+}
+interface RankEditsResult {
+    edits: RankedEdit[];
+}
+interface MasarHealthResult {
+    status: string;
+    version?: string;
+    uptime?: number;
+}
+interface MasarProviderOptions {
+    /** Base URL of the Masar server. Overrides MASAR_URL env var. */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30 000). */
+    timeoutMs?: number;
+}
+declare class MasarError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    constructor(message: string, statusCode: number, responseBody: string);
+}
+declare class MasarProvider {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(options?: MasarProviderOptions);
+    /**
+     * Generate text from a prompt.
+     *
+     * POST /generate
+     */
+    generate(prompt: string, options?: MasarGenerateOptions): Promise<MasarGenerateResult>;
+    /**
+     * Generate a .orb schema via GFlowNet sampling.
+     *
+     * POST /generate/gflownet
+     */
+    generateGFlowNet(goal: GoalSpec): Promise<GFlowNetResult>;
+    /**
+     * Predict validation errors in a .orb schema before compilation.
+     *
+     * POST /predict-errors
+     */
+    predictErrors(schema: string): Promise<PredictErrorsResult>;
+    /**
+     * Rank candidate edits for fixing errors in a .orb schema.
+     *
+     * POST /rank-edits
+     */
+    rankEdits(schema: string, errors: string[]): Promise<RankEditsResult>;
+    /**
+     * Check server health.
+     *
+     * GET /health
+     */
+    health(): Promise<MasarHealthResult>;
+    private post;
+    private get;
+    private request;
+}
+declare function getMasarProvider(options?: MasarProviderOptions): MasarProvider;
+declare function resetMasarProvider(): void;
+
+export { type ErrorPrediction, type GFlowNetResult, type GoalSpec, MasarError, type MasarGenerateOptions, type MasarGenerateResult, type MasarHealthResult, MasarProvider, type MasarProviderOptions, type PredictErrorsResult, type RankEditsResult, type RankedEdit, getMasarProvider, resetMasarProvider };

package/dist/providers/index.js

@@ -0,0 +1,13 @@
+import {
+  MasarError,
+  MasarProvider,
+  getMasarProvider,
+  resetMasarProvider
+} from "../chunk-QOOSH67G.js";
+export {
+  MasarError,
+  MasarProvider,
+  getMasarProvider,
+  resetMasarProvider
+};
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{rate-limiter-9XAWfHwe.d.ts → rate-limiter-DDH7JH5p.d.ts}

@@ -95,4 +95,4 @@ declare class RateLimiter {
 declare function getGlobalRateLimiter(options?: RateLimiterOptions): RateLimiter;
 declare function resetGlobalRateLimiter(): void;
 
-export { RateLimiter as R, TokenTracker as T, type RateLimiterOptions as a, type TokenUsage as b, getGlobalTokenTracker as c, resetGlobalTokenTracker as d, getGlobalRateLimiter as g, resetGlobalRateLimiter as r };
+export { type RateLimiterOptions as R, type TokenUsage as T, RateLimiter as a, TokenTracker as b, getGlobalTokenTracker as c, resetGlobalTokenTracker as d, getGlobalRateLimiter as g, resetGlobalRateLimiter as r };

package/dist/structured-output.d.ts

@@ -1,4 +1,4 @@
-import { a as RateLimiterOptions, b as TokenUsage } from './rate-limiter-9XAWfHwe.js';
+import { R as RateLimiterOptions, T as TokenUsage } from './rate-limiter-DDH7JH5p.js';
 import { z } from 'zod';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/llm",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Multi-provider LLM client with rate limiting, token tracking, structured outputs, and continuation handling",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,10 @@
     "./structured-output": {
       "types": "./dist/structured-output.d.ts",
       "import": "./dist/structured-output.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js"
     }
   },
   "files": [

package/src/index.ts

@@ -94,3 +94,20 @@ export {
   type LLMServiceActions,
   type LLMServiceContract,
 } from './contracts.js';
+
+export {
+  MasarProvider,
+  MasarError,
+  getMasarProvider,
+  resetMasarProvider,
+  type MasarProviderOptions,
+  type MasarGenerateOptions,
+  type MasarGenerateResult,
+  type GoalSpec,
+  type GFlowNetResult,
+  type ErrorPrediction,
+  type PredictErrorsResult,
+  type RankedEdit,
+  type RankEditsResult,
+  type MasarHealthResult,
+} from './providers/index.js';

package/src/providers/index.ts

@@ -0,0 +1,24 @@
+/**
+ * LLM Providers
+ *
+ * Standalone HTTP clients for self-hosted model servers.
+ *
+ * @packageDocumentation
+ */
+
+export {
+  MasarProvider,
+  MasarError,
+  getMasarProvider,
+  resetMasarProvider,
+  type MasarProviderOptions,
+  type MasarGenerateOptions,
+  type MasarGenerateResult,
+  type GoalSpec,
+  type GFlowNetResult,
+  type ErrorPrediction,
+  type PredictErrorsResult,
+  type RankedEdit,
+  type RankEditsResult,
+  type MasarHealthResult,
+} from './masar.js';

package/src/providers/masar.ts

@@ -0,0 +1,272 @@
+/**
+ * Masar Provider
+ *
+ * Thin HTTP client for the Masar neural pipeline server.
+ * Exposes generate, GFlowNet generation, error prediction,
+ * edit ranking, and health-check endpoints.
+ *
+ * Reads `MASAR_URL` from environment (default: http://localhost:8080).
+ *
+ * @packageDocumentation
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface MasarGenerateOptions {
+  /** Model override (server decides default if omitted). */
+  model?: string;
+  /** Sampling temperature. */
+  temperature?: number;
+  /** Maximum tokens to generate. */
+  maxTokens?: number;
+}
+
+export interface MasarGenerateResult {
+  text: string;
+  usage: {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+  };
+}
+
+export interface GoalSpec {
+  /** Natural-language description of the desired application. */
+  description: string;
+  /** Target entities (e.g. ["User", "Product", "Order"]). */
+  entities?: string[];
+  /** Domain hint (e.g. "e-commerce", "healthcare"). */
+  domain?: string;
+  /** Additional constraints passed to the GFlowNet sampler. */
+  constraints?: Record<string, unknown>;
+}
+
+export interface GFlowNetResult {
+  /** Generated .orb schema text. */
+  schema: string;
+  /** Log-probability of the sampled trajectory. */
+  logProb: number;
+  /** Number of sampling steps taken. */
+  steps: number;
+}
+
+export interface ErrorPrediction {
+  /** Line number (1-based) where the error is predicted. */
+  line: number;
+  /** Predicted error category. */
+  category: string;
+  /** Human-readable description. */
+  message: string;
+  /** Confidence score in [0, 1]. */
+  confidence: number;
+}
+
+export interface PredictErrorsResult {
+  errors: ErrorPrediction[];
+}
+
+export interface RankedEdit {
+  /** The proposed replacement text. */
+  edit: string;
+  /** Score assigned by the ranker (higher is better). */
+  score: number;
+  /** Which error this edit addresses. */
+  targetError: string;
+}
+
+export interface RankEditsResult {
+  edits: RankedEdit[];
+}
+
+export interface MasarHealthResult {
+  status: string;
+  version?: string;
+  uptime?: number;
+}
+
+export interface MasarProviderOptions {
+  /** Base URL of the Masar server. Overrides MASAR_URL env var. */
+  baseUrl?: string;
+  /** Request timeout in milliseconds (default: 30 000). */
+  timeoutMs?: number;
+}
+
+// ============================================================================
+// Error
+// ============================================================================
+
+export class MasarError extends Error {
+  constructor(
+    message: string,
+    public readonly statusCode: number,
+    public readonly responseBody: string,
+  ) {
+    super(message);
+    this.name = 'MasarError';
+  }
+}
+
+// ============================================================================
+// Provider
+// ============================================================================
+
+const DEFAULT_BASE_URL = 'https://masar-345008351456.europe-west4.run.app';
+const DEFAULT_TIMEOUT_MS = 30_000;
+
+export class MasarProvider {
+  private readonly baseUrl: string;
+  private readonly timeoutMs: number;
+
+  constructor(options?: MasarProviderOptions) {
+    this.baseUrl = (
+      options?.baseUrl ??
+      process.env.MASAR_URL ??
+      DEFAULT_BASE_URL
+    ).replace(/\/+$/, '');
+    this.timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  }
+
+  // --------------------------------------------------------------------------
+  // Public API
+  // --------------------------------------------------------------------------
+
+  /**
+   * Generate text from a prompt.
+   *
+   * POST /generate
+   */
+  async generate(
+    prompt: string,
+    options?: MasarGenerateOptions,
+  ): Promise<MasarGenerateResult> {
+    return this.post<MasarGenerateResult>('/generate', {
+      prompt,
+      ...options,
+    });
+  }
+
+  /**
+   * Generate a .orb schema via GFlowNet sampling.
+   *
+   * POST /generate/gflownet
+   */
+  async generateGFlowNet(goal: GoalSpec): Promise<GFlowNetResult> {
+    return this.post<GFlowNetResult>('/generate/gflownet', goal);
+  }
+
+  /**
+   * Predict validation errors in a .orb schema before compilation.
+   *
+   * POST /predict-errors
+   */
+  async predictErrors(schema: string): Promise<PredictErrorsResult> {
+    return this.post<PredictErrorsResult>('/predict-errors', { schema });
+  }
+
+  /**
+   * Rank candidate edits for fixing errors in a .orb schema.
+   *
+   * POST /rank-edits
+   */
+  async rankEdits(
+    schema: string,
+    errors: string[],
+  ): Promise<RankEditsResult> {
+    return this.post<RankEditsResult>('/rank-edits', { schema, errors });
+  }
+
+  /**
+   * Check server health.
+   *
+   * GET /health
+   */
+  async health(): Promise<MasarHealthResult> {
+    return this.get<MasarHealthResult>('/health');
+  }
+
+  // --------------------------------------------------------------------------
+  // Internal helpers
+  // --------------------------------------------------------------------------
+
+  private async post<T>(path: string, body: unknown): Promise<T> {
+    return this.request<T>(path, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+  }
+
+  private async get<T>(path: string): Promise<T> {
+    return this.request<T>(path, { method: 'GET' });
+  }
+
+  private async request<T>(
+    path: string,
+    init: RequestInit,
+  ): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+
+    try {
+      const response = await fetch(url, {
+        ...init,
+        signal: controller.signal,
+      });
+
+      if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new MasarError(
+          `Masar ${init.method} ${path} failed with status ${response.status}`,
+          response.status,
+          text,
+        );
+      }
+
+      return (await response.json()) as T;
+    } catch (error) {
+      if (error instanceof MasarError) {
+        throw error;
+      }
+
+      if (error instanceof DOMException && error.name === 'AbortError') {
+        throw new MasarError(
+          `Masar ${init.method} ${path} timed out after ${this.timeoutMs}ms`,
+          0,
+          '',
+        );
+      }
+
+      const message =
+        error instanceof Error ? error.message : String(error);
+      throw new MasarError(
+        `Masar ${init.method} ${path} failed: ${message}`,
+        0,
+        '',
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+}
+
+// ============================================================================
+// Singleton
+// ============================================================================
+
+let sharedInstance: MasarProvider | null = null;
+
+export function getMasarProvider(
+  options?: MasarProviderOptions,
+): MasarProvider {
+  if (!sharedInstance) {
+    sharedInstance = new MasarProvider(options);
+  }
+  return sharedInstance;
+}
+
+export function resetMasarProvider(): void {
+  sharedInstance = null;
+}