@blackdrome/open-deepresearch 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constraints.ts","../src/validators/truth-contract.ts","../src/utils/text.ts","../src/core/engine.ts","../src/adapters/llm/openrouter.ts","../src/adapters/llm/nim.ts","../src/adapters/llm/function-adapter.ts","../src/adapters/search/http-json.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./constraints\";\nexport * from \"./validators/truth-contract\";\nexport { OpenDeepResearchEngine } from \"./core/engine\";\nexport { OpenRouterAdapter, type OpenRouterAdapterConfig } from \"./adapters/llm/openrouter\";\nexport { NimAdapter, type NimAdapterConfig } from \"./adapters/llm/nim\";\nexport { FunctionLlmAdapter, type FunctionAdapterConfig } from \"./adapters/llm/function-adapter\";\nexport { HttpJsonSearchAdapter, type HttpJsonSearchAdapterConfig } from \"./adapters/search/http-json\";\n\nimport type { DeepResearchEngineConfig, LlmAdapter, LlmProviderId, SearchAdapter } from \"./types\";\nimport { OpenDeepResearchEngine } from \"./core/engine\";\nimport { OpenRouterAdapter, type OpenRouterAdapterConfig } from \"./adapters/llm/openrouter\";\nimport { NimAdapter, type NimAdapterConfig } from \"./adapters/llm/nim\";\nimport { FunctionLlmAdapter } from \"./adapters/llm/function-adapter\";\n\nexport type CreateEngineOptions = {\n  searchAdapter: SearchAdapter;\n  defaultProvider?: LlmProviderId;\n  openRouter?: OpenRouterAdapterConfig;\n  nim?: NimAdapterConfig;\n  fallbackComplete?: (prompt: string) => Promise<string>;\n};\n\nexport const createOpenDeepResearchEngine = (options: CreateEngineOptions) => {\n  const llmAdapters: Partial<Record<LlmProviderId, LlmAdapter>> = {};\n\n  if (options.openRouter) {\n    llmAdapters.openrouter = new OpenRouterAdapter(options.openRouter);\n  }\n\n  if (options.nim) {\n    llmAdapters.nim = new NimAdapter(options.nim);\n  }\n\n  if (options.fallbackComplete) {\n    llmAdapters.fallback = new FunctionLlmAdapter({\n      provider: \"fallback\",\n      complete: options.fallbackComplete,\n    });\n  }\n\n  const defaultProvider = options.defaultProvider || \"openrouter\";\n  const config: DeepResearchEngineConfig = {\n    searchAdapter: options.searchAdapter,\n    llmAdapters,\n    defaultProvider,\n  };\n\n  return new OpenDeepResearchEngine(config);\n};\n","import type { SearchConstraints } from \"./types\";\n\nconst FORUM_DOMAIN_MAP: Array<{ pattern: RegExp; domain: string; hint: string }> = [\n  { pattern: /\\breddit\\b|\\br\\/[a-z0-9_]+/i, domain: \"reddit.com\", hint: \"reddit\" },\n  { pattern: /\\bstack\\s*overflow\\b/i, domain: \"stackoverflow.com\", hint: \"stackoverflow\" },\n  { pattern: /\\bstack\\s*exchange\\b|\\bstackexchange\\b/i, domain: \"stackexchange.com\", hint: \"stackexchange\" },\n  { pattern: /\\bhacker\\s*news\\b|\\bhn\\b/i, domain: \"news.ycombinator.com\", hint: \"hackernews\" },\n  { pattern: /\\bquora\\b/i, domain: \"quora.com\", hint: \"quora\" },\n  { pattern: /\\bgithub\\s+issues\\b/i, domain: \"github.com\", hint: \"github\" },\n];\n\nconst STRICT_FORUM_PATTERN =\n  /\\b(?:only|just|strictly|specifically)\\b.*\\b(reddit|stack\\s*overflow|stack\\s*exchange|stackexchange|hacker\\s*news|quora|github)\\b/i;\n\nconst FORUM_PREPOSITION_PATTERN =\n  /\\b(?:from|on|in)\\s+(reddit|stack\\s*overflow|stack\\s*exchange|stackexchange|hacker\\s*news|quora|github)\\b/i;\n\nexport const normalizeDomain = (value: string) =>\n  value.trim().toLowerCase().replace(/^https?:\\/\\//, \"\").replace(/^www\\./, \"\");\n\nconst unique = (items: string[]) => Array.from(new Set(items.filter(Boolean).map(normalizeDomain)));\n\nexport const extractSiteTokens = (query: string) => {\n  const matches = Array.from(query.matchAll(/site:([a-z0-9.-]+)/gi));\n  return unique(matches.map((entry) => entry[1]));\n};\n\nexport const extractSearchConstraints = (query: string): SearchConstraints => {\n  const q = query || \"\";\n  const explicitSites = extractSiteTokens(q);\n  const preferredDomains: string[] = [];\n  const forumHints: string[] = [];\n\n  for (const forum of FORUM_DOMAIN_MAP) {\n    if (!forum.pattern.test(q)) continue;\n    preferredDomains.push(forum.domain);\n    forumHints.push(forum.hint);\n  }\n\n  const enforceByLanguage = STRICT_FORUM_PATTERN.test(q) || FORUM_PREPOSITION_PATTERN.test(q);\n  const enforceRequiredDomains = explicitSites.length > 0 || (preferredDomains.length > 0 && enforceByLanguage);\n  const requiredDomains = enforceRequiredDomains\n    ? explicitSites.length > 0\n      ? explicitSites\n      : preferredDomains\n    : explicitSites;\n\n  return {\n    requiredDomains: unique(requiredDomains),\n    preferredDomains: unique(preferredDomains),\n    enforceRequiredDomains,\n    forumHints: Array.from(new Set(forumHints)),\n  };\n};\n\nexport const domainMatches = (urlOrDomain: string, targetDomains: string[]) => {\n  if (!targetDomains.length) return true;\n\n  let host = normalizeDomain(urlOrDomain);\n  try {\n    host = normalizeDomain(new URL(urlOrDomain).hostname);\n  } catch {\n    host = normalizeDomain(urlOrDomain);\n  }\n\n  return targetDomains.some((targetRaw) => {\n    const target = normalizeDomain(targetRaw);\n    return host === target || host.endsWith(`.${target}`);\n  });\n};\n\nexport const mergeConstraints = (\n  base: SearchConstraints,\n  incoming?: Partial<SearchConstraints>\n): SearchConstraints => {\n  const requiredDomains = unique([...(base.requiredDomains || []), ...(incoming?.requiredDomains || [])]);\n  const preferredDomains = unique([...(base.preferredDomains || []), ...(incoming?.preferredDomains || [])]);\n  const forumHints = Array.from(new Set([...(base.forumHints || []), ...(incoming?.forumHints || [])]));\n  const enforceRequiredDomains = Boolean(\n    incoming?.enforceRequiredDomains ?? (base.enforceRequiredDomains || requiredDomains.length > 0)\n  );\n\n  return {\n    requiredDomains,\n    preferredDomains,\n    forumHints,\n    enforceRequiredDomains,\n  };\n};\n","export type TruthContractStrictness = \"standard\" | \"strict\";\n\nexport type TruthContractCheck = {\n  passed: boolean;\n  violations: string[];\n};\n\nexport const buildTruthContractInstruction = (strictness: TruthContractStrictness) => {\n  const strictLine =\n    strictness === \"strict\"\n      ? \"Do not present uncertain claims as facts. If uncertain, explicitly state uncertainty.\"\n      : \"Prefer high-confidence claims and note uncertainty briefly when needed.\";\n\n  return [\n    \"TRUTH CONTRACT:\",\n    \"- Lead with the direct answer in 1-2 sentences.\",\n    \"- Do not invent sources or facts.\",\n    \"- If web or dossier sources are provided, cite claims as [1], [2], etc.\",\n    \"- Include a short 'What is uncertain' note when confidence is limited.\",\n    strictLine,\n  ].join(\"\\n\");\n};\n\nexport const evaluateTruthContract = (\n  response: string,\n  options?: { requiresCitations?: boolean; strictness?: TruthContractStrictness }\n): TruthContractCheck => {\n  const text = (response || \"\").trim();\n  const violations: string[] = [];\n\n  if (!text) {\n    return {\n      passed: false,\n      violations: [\"Empty response\"],\n    };\n  }\n\n  const hasCitation = /\\[\\d+\\]/.test(text);\n  if (options?.requiresCitations && !hasCitation) {\n    violations.push(\"Missing source citations in bracket format like [1]\");\n  }\n\n  const hasUncertaintySection = /what is uncertain/i.test(text) || /uncertain|not enough evidence|insufficient data/i.test(text);\n  if (options?.strictness === \"strict\" && !hasUncertaintySection) {\n    violations.push(\"No explicit uncertainty note found in strict mode\");\n  }\n\n  const hasOverconfidentPhrases = /guaranteed|always true|definitely 100%|undeniably/i.test(text);\n  if (hasOverconfidentPhrases) {\n    violations.push(\"Contains overconfident phrasing\");\n  }\n\n  return {\n    passed: violations.length === 0,\n    violations,\n  };\n};\n","const STOPWORDS = new Set([\n  \"the\",\n  \"a\",\n  \"an\",\n  \"and\",\n  \"or\",\n  \"to\",\n  \"for\",\n  \"of\",\n  \"in\",\n  \"on\",\n  \"with\",\n  \"is\",\n  \"are\",\n  \"was\",\n  \"were\",\n  \"be\",\n  \"as\",\n  \"at\",\n  \"from\",\n  \"by\",\n  \"that\",\n  \"this\",\n  \"it\",\n  \"about\",\n  \"into\",\n  \"what\",\n  \"which\",\n  \"who\",\n  \"when\",\n  \"where\",\n  \"how\",\n]);\n\nexport const NEGATION_TERMS = [\"not\", \"never\", \"no\", \"without\", \"cannot\", \"can't\", \"didn't\"];\n\nexport const normalizeUrl = (url: string) => {\n  try {\n    const parsed = new URL(url);\n    parsed.hash = \"\";\n    [\"utm_source\", \"utm_medium\", \"utm_campaign\", \"utm_term\", \"utm_content\"].forEach((key) => {\n      parsed.searchParams.delete(key);\n    });\n    return parsed.toString();\n  } catch {\n    return url.trim();\n  }\n};\n\nexport const domainOf = (url: string) => {\n  try {\n    return new URL(url).hostname.replace(/^www\\./, \"\").toLowerCase();\n  } catch {\n    return url.trim().toLowerCase();\n  }\n};\n\nexport const toTokens = (text: string) =>\n  text\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s]/g, \" \")\n    .split(/\\s+/)\n    .map((token) => token.trim())\n    .filter((token) => token.length > 2 && !STOPWORDS.has(token));\n\nexport const lexicalScore = (query: string, text: string) => {\n  const queryTokens = toTokens(query);\n  if (!queryTokens.length) return 0;\n\n  const textTokens = new Set(toTokens(text));\n  let hits = 0;\n  for (const token of queryTokens) {\n    if (textTokens.has(token)) hits += 1;\n  }\n  return hits / queryTokens.length;\n};\n\nexport const jaccardSimilarity = (a: string, b: string) => {\n  const aTokens = new Set(toTokens(a));\n  const bTokens = new Set(toTokens(b));\n  if (!aTokens.size || !bTokens.size) return 0;\n\n  let intersection = 0;\n  for (const token of aTokens) {\n    if (bTokens.has(token)) intersection += 1;\n  }\n\n  const union = aTokens.size + bTokens.size - intersection;\n  return union === 0 ? 0 : intersection / union;\n};\n\nexport const sentenceCandidates = (snippet: string) =>\n  snippet\n    .split(/(?<=[.!?])\\s+/)\n    .map((sentence) => sentence.trim())\n    .filter((sentence) => sentence.length >= 35)\n    .slice(0, 2);\n\nexport const hasNegation = (text: string) => {\n  const lower = text.toLowerCase();\n  return NEGATION_TERMS.some((term) => lower.includes(term));\n};\n\nexport const extractNumericTokens = (text: string) => Array.from(text.matchAll(/\\b\\d+(?:\\.\\d+)?%?\\b/g)).map((m) => m[0]);\n\nexport const authorityScore = (domain: string) => {\n  if (domain.endsWith(\".gov\") || domain.endsWith(\".edu\")) return 1;\n  if (domain.includes(\"wikipedia.org\")) return 0.9;\n  if (domain.includes(\"stackoverflow.com\") || domain.includes(\"stackexchange.com\")) return 0.85;\n  if (domain.includes(\"github.com\")) return 0.8;\n  if (domain.includes(\"reddit.com\")) return 0.72;\n  return 0.56;\n};\n\nexport const recencyScore = (text: string, url: string) => {\n  const year = new Date().getFullYear();\n  const bag = `${text} ${url}`;\n  if (bag.includes(String(year))) return 1;\n  if (bag.includes(String(year - 1))) return 0.82;\n  if (bag.includes(String(year - 2))) return 0.65;\n  return 0.48;\n};\n","import { domainMatches, extractSearchConstraints, mergeConstraints } from \"../constraints\";\nimport type {\n  ClaimCluster,\n  DeepResearchDepth,\n  DeepResearchEngineConfig,\n  DeepResearchProgress,\n  DeepResearchRun,\n  DeepResearchRunOptions,\n  PlannedQuery,\n  RankedSource,\n  SearchConstraints,\n  SearchResult,\n} from \"../types\";\nimport {\n  authorityScore,\n  domainOf,\n  extractNumericTokens,\n  hasNegation,\n  jaccardSimilarity,\n  lexicalScore,\n  normalizeUrl,\n  recencyScore,\n  sentenceCandidates,\n} from \"../utils/text\";\nimport { buildTruthContractInstruction, evaluateTruthContract } from \"../validators/truth-contract\";\n\nconst DEPTH_CONFIG: Record<\n  DeepResearchDepth,\n  {\n    initialQueries: number;\n    refinementQueries: number;\n    sourceLimit: number;\n    maxPerDomain: number;\n    minDomainDiversity: number;\n  }\n> = {\n  standard: {\n    initialQueries: 5,\n    refinementQueries: 2,\n    sourceLimit: 12,\n    maxPerDomain: 3,\n    minDomainDiversity: 3,\n  },\n  deep: {\n    initialQueries: 8,\n    refinementQueries: 4,\n    sourceLimit: 20,\n    maxPerDomain: 4,\n    minDomainDiversity: 4,\n  },\n  extreme: {\n    initialQueries: 12,\n    refinementQueries: 6,\n    sourceLimit: 30,\n    maxPerDomain: 5,\n    minDomainDiversity: 5,\n  },\n};\n\nconst confidenceFromSupport = (citations: number, domains: number): ClaimCluster[\"confidence\"] => {\n  if (citations >= 3 && domains >= 2) return \"high\";\n  if (citations >= 2) return \"medium\";\n  return \"low\";\n};\n\nexport class OpenDeepResearchEngine {\n  private readonly resultCache = new Map<string, SearchResult[]>();\n\n  constructor(private readonly config: DeepResearchEngineConfig) {}\n\n  private emit(\n    onProgress: ((progress: DeepResearchProgress) => void) | undefined,\n    stage: DeepResearchProgress[\"stage\"],\n    message: string,\n    completed: number,\n    total: number\n  ) {\n    onProgress?.({ stage, message, completed, total });\n  }\n\n  private buildPlan(query: string, depth: DeepResearchDepth, constraints: SearchConstraints): PlannedQuery[] {\n    const cfg = DEPTH_CONFIG[depth];\n\n    const seed: PlannedQuery[] = [\n      { query, intent: \"Core answer\" },\n      { query: `${query} latest updates facts`, intent: \"Fresh context\" },\n      { query: `${query} benchmark comparison`, intent: \"Comparative evidence\" },\n      { query: `${query} data statistics report`, intent: \"Quantitative evidence\" },\n      { query: `${query} criticism limitations`, intent: \"Counter evidence\" },\n      { query: `${query} implementation guide`, intent: \"Practical implementation\" },\n      { query: `${query} official documentation`, intent: \"Primary source\" },\n      { query: `${query} common mistakes pitfalls`, intent: \"Failure patterns\" },\n      { query: `${query} timeline history`, intent: \"Historical context\" },\n      { query: `${query} expert analysis`, intent: \"Expert opinion\" },\n    ];\n\n    for (const domain of constraints.requiredDomains.slice(0, 4)) {\n      seed.unshift({\n        query: `${query} site:${domain}`,\n        intent: `Required domain evidence (${domain})`,\n        constrainedToDomain: domain,\n      });\n    }\n\n    for (const domain of constraints.preferredDomains.slice(0, 3)) {\n      seed.unshift({\n        query: `${query} discussion site:${domain}`,\n        intent: `Preferred domain signal (${domain})`,\n        constrainedToDomain: domain,\n      });\n    }\n\n    const unique = new Map<string, PlannedQuery>();\n    for (const row of seed) {\n      const key = row.query.toLowerCase().trim();\n      if (!unique.has(key)) unique.set(key, row);\n    }\n\n    return Array.from(unique.values()).slice(0, cfg.initialQueries);\n  }\n\n  private buildRefinementQueries(\n    query: string,\n    rankedSources: RankedSource[],\n    constraints: SearchConstraints,\n    depth: DeepResearchDepth\n  ): PlannedQuery[] {\n    const cfg = DEPTH_CONFIG[depth];\n    const diversity = new Set(rankedSources.map((source) => source.domain)).size;\n    const lowDiversity = diversity < cfg.minDomainDiversity;\n\n    const candidates: PlannedQuery[] = [\n      { query: `${query} contradictory findings`, intent: \"Conflict checks\" },\n      { query: `${query} independent validation`, intent: \"Independent corroboration\" },\n      { query: `${query} known caveats`, intent: \"Known caveats\" },\n      { query: `${query} recent updates this year`, intent: \"Recency refresh\" },\n      { query: `${query} real world case study`, intent: \"Case studies\" },\n    ];\n\n    if (lowDiversity) {\n      candidates.push({ query: `${query} alternative sources analysis`, intent: \"Diversity expansion\" });\n    }\n\n    for (const domain of constraints.requiredDomains.slice(0, 3)) {\n      candidates.push({\n        query: `${query} site:${domain}`,\n        intent: `Required domain refinement (${domain})`,\n        constrainedToDomain: domain,\n      });\n    }\n\n    const unique = new Map<string, PlannedQuery>();\n    for (const row of candidates) {\n      const key = row.query.toLowerCase().trim();\n      if (!unique.has(key)) unique.set(key, row);\n    }\n\n    return Array.from(unique.values()).slice(0, cfg.refinementQueries);\n  }\n\n  private async retrieveWithCache(query: string, constraints: SearchConstraints): Promise<SearchResult[]> {\n    const cacheKey = [\n      query.toLowerCase().trim(),\n      constraints.requiredDomains.join(\",\"),\n      constraints.preferredDomains.join(\",\"),\n      String(constraints.enforceRequiredDomains),\n    ].join(\"|\");\n\n    const cached = this.resultCache.get(cacheKey);\n    if (cached) return cached;\n\n    const results = await this.config.searchAdapter.search(query, {\n      sites: constraints.requiredDomains,\n      preferredSites: constraints.preferredDomains,\n      enforceSites: constraints.enforceRequiredDomains,\n      forumHints: constraints.forumHints,\n    });\n\n    const filtered = results.filter((result) => result.url && result.url !== \"#\" && result.title !== \"Search Error\");\n    this.resultCache.set(cacheKey, filtered);\n    return filtered;\n  }\n\n  private rank(\n    question: string,\n    rows: Array<{ plannedQuery: string; constrainedToDomain?: string; result: SearchResult }>,\n    depth: DeepResearchDepth,\n    constraints: SearchConstraints\n  ): RankedSource[] {\n    const cfg = DEPTH_CONFIG[depth];\n    const deduped = new Set<string>();\n    const scored: RankedSource[] = [];\n\n    for (const row of rows) {\n      const url = normalizeUrl(row.result.url);\n      if (!url || deduped.has(url)) continue;\n      deduped.add(url);\n\n      const domain = domainOf(url);\n      if (constraints.enforceRequiredDomains && constraints.requiredDomains.length > 0) {\n        if (!domainMatches(domain, constraints.requiredDomains)) continue;\n      }\n\n      const preferredBoost =\n        constraints.preferredDomains.length > 0 && domainMatches(domain, constraints.preferredDomains) ? 1 : 0;\n      const constrainedBoost = row.constrainedToDomain && domainMatches(domain, [row.constrainedToDomain]) ? 1 : 0;\n\n      const score =\n        lexicalScore(question, `${row.result.title} ${row.result.snippet}`) * 0.45 +\n        lexicalScore(row.plannedQuery, `${row.result.title} ${row.result.snippet}`) * 0.15 +\n        authorityScore(domain) * 0.15 +\n        recencyScore(`${row.result.title} ${row.result.snippet}`, url) * 0.1 +\n        preferredBoost * 0.1 +\n        constrainedBoost * 0.05;\n\n      scored.push({\n        id: 0,\n        title: row.result.title,\n        snippet: row.result.snippet,\n        url,\n        domain,\n        score,\n        retrievedFrom: row.plannedQuery,\n      });\n    }\n\n    scored.sort((a, b) => b.score - a.score);\n\n    const diversified: RankedSource[] = [];\n    const domainCounts = new Map<string, number>();\n\n    for (const source of scored) {\n      const seenFromDomain = domainCounts.get(source.domain) || 0;\n      if (seenFromDomain >= cfg.maxPerDomain) continue;\n\n      diversified.push(source);\n      domainCounts.set(source.domain, seenFromDomain + 1);\n      if (diversified.length >= cfg.sourceLimit) break;\n    }\n\n    return diversified.map((entry, index) => ({ ...entry, id: index + 1 }));\n  }\n\n  private verify(rankedSources: RankedSource[]): {\n    claims: ClaimCluster[];\n    contradictions: string[];\n    unresolvedQuestions: string[];\n  } {\n    const clusters: Array<{\n      claim: string;\n      citationIds: Set<number>;\n      domains: Set<string>;\n    }> = [];\n\n    for (const source of rankedSources) {\n      const candidates = sentenceCandidates(source.snippet || source.title);\n      if (!candidates.length && source.title) candidates.push(source.title);\n\n      for (const sentence of candidates) {\n        let attached = false;\n        for (const cluster of clusters) {\n          if (jaccardSimilarity(cluster.claim, sentence) >= 0.66) {\n            cluster.citationIds.add(source.id);\n            cluster.domains.add(source.domain);\n            attached = true;\n            break;\n          }\n        }\n\n        if (!attached) {\n          clusters.push({\n            claim: sentence,\n            citationIds: new Set([source.id]),\n            domains: new Set([source.domain]),\n          });\n        }\n      }\n    }\n\n    const claims = clusters\n      .map<ClaimCluster>((cluster) => {\n        const citationIds = Array.from(cluster.citationIds).sort((a, b) => a - b);\n        const domains = Array.from(cluster.domains);\n        return {\n          claim: cluster.claim,\n          citationIds,\n          domains,\n          confidence: confidenceFromSupport(citationIds.length, domains.length),\n        };\n      })\n      .sort((a, b) => {\n        const scoreA = a.citationIds.length * 10 + (a.confidence === \"high\" ? 3 : a.confidence === \"medium\" ? 2 : 1);\n        const scoreB = b.citationIds.length * 10 + (b.confidence === \"high\" ? 3 : b.confidence === \"medium\" ? 2 : 1);\n        return scoreB - scoreA;\n      })\n      .slice(0, 20);\n\n    const contradictions: string[] = [];\n    for (let i = 0; i < claims.length; i += 1) {\n      for (let j = i + 1; j < claims.length; j += 1) {\n        const left = claims[i];\n        const right = claims[j];\n        if (jaccardSimilarity(left.claim, right.claim) < 0.78) continue;\n\n        const negationConflict = hasNegation(left.claim) !== hasNegation(right.claim);\n        const leftNumbers = extractNumericTokens(left.claim);\n        const rightNumbers = extractNumericTokens(right.claim);\n        const numericConflict =\n          leftNumbers.length > 0 && rightNumbers.length > 0 && leftNumbers.join(\"|\") !== rightNumbers.join(\"|\");\n\n        if (negationConflict || numericConflict) {\n          contradictions.push(\n            `Potential conflict between [${left.citationIds[0]}] and [${right.citationIds[0]}] on similar claim wording.`\n          );\n        }\n      }\n    }\n\n    const unresolvedQuestions = claims\n      .filter((claim) => claim.confidence === \"low\")\n      .slice(0, 4)\n      .map((claim) => `Need stronger corroboration for: ${claim.claim}`);\n\n    return {\n      claims,\n      contradictions: Array.from(new Set(contradictions)).slice(0, 6),\n      unresolvedQuestions,\n    };\n  }\n\n  private buildPromptContext(params: {\n    query: string;\n    depth: DeepResearchDepth;\n    plan: PlannedQuery[];\n    retrievalRounds: number;\n    constraints: SearchConstraints;\n    claims: ClaimCluster[];\n    contradictions: string[];\n    unresolvedQuestions: string[];\n    rankedSources: RankedSource[];\n    contextBlocks?: string[];\n  }) {\n    const constraintsLine = params.constraints.requiredDomains.length\n      ? `Required domains: ${params.constraints.requiredDomains.join(\", \")} (strict=${String(\n          params.constraints.enforceRequiredDomains\n        )})`\n      : params.constraints.preferredDomains.length\n        ? `Preferred domains: ${params.constraints.preferredDomains.join(\", \")}`\n        : \"No strict domain constraints requested.\";\n\n    const sourcePayload = params.rankedSources.map((source) => ({\n      id: source.id,\n      title: source.title,\n      snippet: source.snippet,\n      url: source.url,\n      domain: source.domain,\n      score: Number(source.score.toFixed(4)),\n      retrievedFrom: source.retrievedFrom,\n    }));\n\n    const claimPayload = params.claims.map((claim) => ({\n      claim: claim.claim,\n      confidence: claim.confidence,\n      citations: claim.citationIds,\n      domains: claim.domains,\n    }));\n\n    const contextSection = (params.contextBlocks || []).filter(Boolean);\n\n    return [\n      \"UPAI OPEN DEEPRESEARCH DOSSIER\",\n      `Question: ${params.query}`,\n      `Depth: ${params.depth}`,\n      `Retrieval rounds: ${params.retrievalRounds}`,\n      constraintsLine,\n      \"\",\n      ...(contextSection.length ? [\"Additional context:\", ...contextSection, \"\"] : []),\n      \"Research plan:\",\n      ...params.plan.map((entry, index) => `${index + 1}. ${entry.intent}: ${entry.query}`),\n      \"\",\n      \"Claim graph:\",\n      \"```json\",\n      JSON.stringify(claimPayload, null, 2),\n      \"```\",\n      \"\",\n      \"Evidence table:\",\n      \"```json\",\n      JSON.stringify(sourcePayload, null, 2),\n      \"```\",\n      \"\",\n      \"Contradictions:\",\n      params.contradictions.length ? params.contradictions.join(\"\\n\") : \"None detected.\",\n      \"\",\n      \"Unresolved questions:\",\n      params.unresolvedQuestions.length ? params.unresolvedQuestions.join(\"\\n\") : \"None\",\n      \"\",\n      \"Answer requirements:\",\n      \"1) Start with a direct answer in 1-2 sentences.\",\n      \"2) Use only evidence supported by citations from this dossier.\",\n      \"3) Cite evidence as [1], [2], ... with bracket IDs.\",\n      \"4) Add a short 'What is uncertain' section.\",\n      \"5) If contradictions exist, explicitly mention them.\",\n      \"6) Respect required/preferred domain constraints in framing.\",\n      \"\",\n      buildTruthContractInstruction(\"strict\"),\n    ].join(\"\\n\");\n  }\n\n  private async synthesize(promptContext: string, providerHint?: DeepResearchRunOptions[\"providerHint\"]) {\n    const order: Array<\"openrouter\" | \"nim\" | \"fallback\"> = [];\n    if (providerHint) order.push(providerHint);\n    if (!order.includes(this.config.defaultProvider)) order.push(this.config.defaultProvider);\n    for (const key of [\"openrouter\", \"nim\", \"fallback\"] as const) {\n      if (!order.includes(key)) order.push(key);\n    }\n\n    const errors: string[] = [];\n    for (const provider of order) {\n      const adapter = this.config.llmAdapters[provider];\n      if (!adapter) continue;\n\n      try {\n        const answer = await adapter.complete(`${promptContext}\\n\\nNow produce the final answer.`);\n        if (answer.trim()) {\n          return { provider, answer };\n        }\n      } catch (error) {\n        errors.push(`${provider}: ${error instanceof Error ? error.message : String(error)}`);\n      }\n    }\n\n    throw new Error(`All synthesis providers failed. ${errors.join(\" | \")}`);\n  }\n\n  async run(query: string, options?: DeepResearchRunOptions): Promise<DeepResearchRun> {\n    const depth = options?.depth || \"deep\";\n    const onProgress = options?.onProgress;\n    const cfg = DEPTH_CONFIG[depth];\n\n    const inferred = extractSearchConstraints(query);\n    const constraints = mergeConstraints(inferred, options?.constraints);\n\n    this.emit(onProgress, \"planning\", \"Planning multi-angle research queries...\", 1, 6);\n    const plan = this.buildPlan(query, depth, constraints);\n\n    const gathered: Array<{ plannedQuery: string; constrainedToDomain?: string; result: SearchResult }> = [];\n\n    this.emit(onProgress, \"retrieving\", \"Running retrieval round 1...\", 2, 6);\n    for (let index = 0; index < plan.length; index += 1) {\n      const step = plan[index];\n      this.emit(onProgress, \"retrieving\", `Query ${index + 1}/${plan.length}: ${step.intent}`, 2, 6);\n\n      const results = await this.retrieveWithCache(step.query, constraints);\n      for (const result of results) {\n        gathered.push({ plannedQuery: step.query, constrainedToDomain: step.constrainedToDomain, result });\n      }\n    }\n\n    let retrievalRounds = 1;\n    let rankedSources = this.rank(query, gathered, depth, constraints);\n    const diversity = new Set(rankedSources.map((source) => source.domain)).size;\n    const needsRefinement =\n      depth !== \"standard\" &&\n      (rankedSources.length < Math.floor(cfg.sourceLimit * 0.7) || diversity < cfg.minDomainDiversity);\n\n    if (needsRefinement) {\n      retrievalRounds += 1;\n      const refinementPlan = this.buildRefinementQueries(query, rankedSources, constraints, depth);\n      this.emit(onProgress, \"retrieving\", \"Running adaptive refinement queries...\", 2, 6);\n\n      for (let index = 0; index < refinementPlan.length; index += 1) {\n        const step = refinementPlan[index];\n        this.emit(onProgress, \"retrieving\", `Refinement ${index + 1}/${refinementPlan.length}: ${step.intent}`, 2, 6);\n\n        const results = await this.retrieveWithCache(step.query, constraints);\n        for (const result of results) {\n          gathered.push({ plannedQuery: step.query, constrainedToDomain: step.constrainedToDomain, result });\n        }\n      }\n\n      rankedSources = this.rank(query, gathered, depth, constraints);\n    }\n\n    this.emit(onProgress, \"ranking\", \"Ranking and diversifying evidence...\", 3, 6);\n    this.emit(onProgress, \"verifying\", \"Building claim graph and contradiction checks...\", 4, 6);\n    const { claims, contradictions, unresolvedQuestions } = this.verify(rankedSources);\n\n    this.emit(onProgress, \"synthesizing\", \"Synthesizing final answer with citations...\", 5, 6);\n    const promptContext = this.buildPromptContext({\n      query,\n      depth,\n      plan,\n      retrievalRounds,\n      constraints,\n      claims,\n      contradictions,\n      unresolvedQuestions,\n      rankedSources,\n      contextBlocks: options?.contextBlocks,\n    });\n\n    const synthesis = await this.synthesize(promptContext, options?.providerHint);\n    let finalAnswer = synthesis.answer;\n\n    this.emit(onProgress, \"critiquing\", \"Running citation/uncertainty critique pass...\", 6, 6);\n    const critique = evaluateTruthContract(finalAnswer, {\n      requiresCitations: rankedSources.length > 0,\n      strictness: \"strict\",\n    });\n\n    if (!critique.passed) {\n      const repairPrompt = [\n        promptContext,\n        \"\",\n        \"Your previous answer violated the response contract.\",\n        `Violations: ${critique.violations.join(\"; \")}`,\n        \"Rewrite the answer to satisfy all requirements.\",\n        \"\",\n        \"Previous answer:\",\n        finalAnswer,\n      ].join(\"\\n\");\n\n      const adapter = this.config.llmAdapters[synthesis.provider];\n      if (adapter) {\n        try {\n          const repaired = await adapter.complete(repairPrompt);\n          if (repaired.trim()) finalAnswer = repaired;\n        } catch {\n          // Keep original answer if repair fails\n        }\n      }\n    }\n\n    const sourcesForMessage: SearchResult[] = rankedSources.map((source) => ({\n      title: source.title,\n      snippet: source.snippet,\n      url: source.url,\n    }));\n\n    return {\n      query,\n      depth,\n      plan,\n      retrievalRounds,\n      rankedSources,\n      claims,\n      contradictions,\n      unresolvedQuestions,\n      promptContext,\n      finalAnswer,\n      synthesis: {\n        provider: synthesis.provider,\n        critiqueViolations: critique.violations,\n      },\n      constraints,\n      sourcesForMessage,\n    };\n  }\n}\n","import type { LlmAdapter } from \"../../types\";\n\nexport type OpenRouterAdapterConfig = {\n  apiKey: string;\n  model: string;\n  endpoint?: string;\n  siteUrl?: string;\n  siteName?: string;\n  timeoutMs?: number;\n};\n\ntype OpenRouterResponse = {\n  choices?: Array<{\n    message?: {\n      content?: string;\n    };\n  }>;\n  error?: {\n    message?: string;\n  };\n};\n\nexport class OpenRouterAdapter implements LlmAdapter {\n  provider = \"openrouter\" as const;\n  private readonly endpoint: string;\n  private readonly timeoutMs: number;\n  private readonly siteUrl: string;\n  private readonly siteName: string;\n\n  constructor(private readonly config: OpenRouterAdapterConfig) {\n    this.endpoint = config.endpoint || \"https://openrouter.ai/api/v1/chat/completions\";\n    this.timeoutMs = config.timeoutMs || 60000;\n    this.siteUrl = config.siteUrl || \"https://github.com/blackdrome/upai-open-deepresearch\";\n    this.siteName = config.siteName || \"UPAI Open DeepResearch\";\n  }\n\n  async complete(prompt: string): Promise<string> {\n    if (!this.config.apiKey) {\n      throw new Error(\"OpenRouter API key is required.\");\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await fetch(this.endpoint, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n          \"HTTP-Referer\": this.siteUrl,\n          \"X-Title\": this.siteName,\n        },\n        body: JSON.stringify({\n          model: this.config.model,\n          messages: [\n            {\n              role: \"system\",\n              content: \"You are a grounded research synthesis model. Keep claims source-bound and concise.\",\n            },\n            {\n              role: \"user\",\n              content: prompt,\n            },\n          ],\n          stream: false,\n          temperature: 0.2,\n        }),\n        signal: controller.signal,\n      });\n\n      const raw = await response.text();\n      let payload: OpenRouterResponse | null = null;\n      try {\n        payload = JSON.parse(raw) as OpenRouterResponse;\n      } catch {\n        payload = null;\n      }\n\n      if (!response.ok) {\n        throw new Error(payload?.error?.message || raw || `OpenRouter request failed (${response.status})`);\n      }\n\n      const text = payload?.choices?.[0]?.message?.content?.trim();\n      if (!text) {\n        throw new Error(\"OpenRouter returned an empty completion.\");\n      }\n\n      return text;\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n","import type { LlmAdapter } from \"../../types\";\n\nexport type NimAdapterConfig = {\n  apiKey: string;\n  model: string;\n  endpoint?: string;\n  timeoutMs?: number;\n  maxTokens?: number;\n  temperature?: number;\n};\n\ntype NimResponse = {\n  choices?: Array<{\n    message?: {\n      content?: string | Array<{ type?: string; text?: string }>;\n    };\n  }>;\n  error?: {\n    message?: string;\n  };\n  message?: string;\n  detail?: string;\n};\n\nconst normalizeNimError = (status: number, raw: string, parsed?: NimResponse | null) => {\n  const text = parsed?.error?.message || parsed?.message || parsed?.detail || raw || `NIM request failed (${status})`;\n  const lowered = text.toLowerCase();\n\n  if (lowered.includes(\"not found for account\") || /function\\s+'[^']+'\\s*:\\s*not found/i.test(text)) {\n    return \"Selected NVIDIA NIM model is unavailable for this account.\";\n  }\n\n  if (status === 401 || lowered.includes(\"authentication\") || lowered.includes(\"invalid api key\")) {\n    return \"NVIDIA NIM authentication failed. Verify your API key.\";\n  }\n\n  if (status === 429 || lowered.includes(\"rate limit\")) {\n    return \"NVIDIA NIM rate limit reached. Retry later or switch model.\";\n  }\n\n  if (status === 408 || lowered.includes(\"timed out\") || lowered.includes(\"timeout\")) {\n    return \"NVIDIA NIM timed out. Try a faster model or reduce response size.\";\n  }\n\n  return text;\n};\n\nexport class NimAdapter implements LlmAdapter {\n  provider = \"nim\" as const;\n  private readonly endpoint: string;\n  private readonly timeoutMs: number;\n  private readonly maxTokens: number;\n  private readonly temperature: number;\n\n  constructor(private readonly config: NimAdapterConfig) {\n    this.endpoint = config.endpoint || \"https://integrate.api.nvidia.com/v1/chat/completions\";\n    this.timeoutMs = config.timeoutMs || 70000;\n    this.maxTokens = config.maxTokens || 1100;\n    this.temperature = config.temperature ?? 0.2;\n  }\n\n  async complete(prompt: string): Promise<string> {\n    if (!this.config.apiKey) {\n      throw new Error(\"NVIDIA NIM API key is required.\");\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await fetch(this.endpoint, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          model: this.config.model,\n          messages: [{ role: \"user\", content: prompt }],\n          max_tokens: this.maxTokens,\n          temperature: this.temperature,\n          stream: false,\n        }),\n        signal: controller.signal,\n      });\n\n      const raw = await response.text();\n      let payload: NimResponse | null = null;\n      try {\n        payload = JSON.parse(raw) as NimResponse;\n      } catch {\n        payload = null;\n      }\n\n      if (!response.ok) {\n        throw new Error(normalizeNimError(response.status, raw, payload));\n      }\n\n      const content = payload?.choices?.[0]?.message?.content;\n      const text =\n        typeof content === \"string\"\n          ? content\n          : Array.isArray(content)\n            ? content.map((entry) => entry.text || \"\").join(\"\\n\").trim()\n            : \"\";\n\n      if (!text) {\n        throw new Error(\"NVIDIA NIM returned an empty completion.\");\n      }\n\n      return text;\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(\"NVIDIA NIM request timed out.\");\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n","import type { LlmAdapter, LlmProviderId } from \"../../types\";\n\nexport type FunctionAdapterConfig = {\n  provider: LlmProviderId;\n  complete: (prompt: string) => Promise<string>;\n};\n\nexport class FunctionLlmAdapter implements LlmAdapter {\n  provider: LlmProviderId;\n\n  constructor(private readonly config: FunctionAdapterConfig) {\n    this.provider = config.provider;\n  }\n\n  complete(prompt: string): Promise<string> {\n    return this.config.complete(prompt);\n  }\n}\n","import type { SearchAdapter, SearchOptions, SearchResult } from \"../../types\";\n\nexport type HttpJsonSearchAdapterConfig = {\n  endpoint: string;\n  method?: \"GET\" | \"POST\";\n  apiKey?: string;\n  apiKeyHeader?: string;\n  timeoutMs?: number;\n  extraHeaders?: Record<string, string>;\n  staticPayload?: Record<string, unknown>;\n};\n\ntype GenericSearchPayload = {\n  results?: SearchResult[];\n  items?: Array<{ title?: string; snippet?: string; url?: string; link?: string }>;\n  error?: string;\n};\n\nconst sanitizeResults = (input: SearchResult[]) =>\n  input.filter((item) => item.url && item.url !== \"#\" && item.title).map((item) => ({\n    title: item.title,\n    snippet: item.snippet || \"\",\n    url: item.url,\n  }));\n\nexport class HttpJsonSearchAdapter implements SearchAdapter {\n  private readonly method: \"GET\" | \"POST\";\n  private readonly timeoutMs: number;\n  private readonly apiKeyHeader: string;\n\n  constructor(private readonly config: HttpJsonSearchAdapterConfig) {\n    this.method = config.method || \"POST\";\n    this.timeoutMs = config.timeoutMs || 20000;\n    this.apiKeyHeader = config.apiKeyHeader || \"Authorization\";\n  }\n\n  async search(query: string, options: SearchOptions): Promise<SearchResult[]> {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const headers: Record<string, string> = {\n        \"Content-Type\": \"application/json\",\n        ...(this.config.extraHeaders || {}),\n      };\n\n      if (this.config.apiKey) {\n        headers[this.apiKeyHeader] =\n          this.apiKeyHeader.toLowerCase() === \"authorization\"\n            ? `Bearer ${this.config.apiKey}`\n            : this.config.apiKey;\n      }\n\n      const payload = {\n        query,\n        ...this.config.staticPayload,\n        sites: options.sites || [],\n        preferredSites: options.preferredSites || [],\n        enforceSites: Boolean(options.enforceSites),\n        forumHints: options.forumHints || [],\n      };\n\n      let response: Response;\n      if (this.method === \"GET\") {\n        const url = new URL(this.config.endpoint);\n        url.searchParams.set(\"query\", query);\n        response = await fetch(url.toString(), {\n          method: \"GET\",\n          headers,\n          signal: controller.signal,\n        });\n      } else {\n        response = await fetch(this.config.endpoint, {\n          method: \"POST\",\n          headers,\n          body: JSON.stringify(payload),\n          signal: controller.signal,\n        });\n      }\n\n      const raw = await response.text();\n      let parsed: GenericSearchPayload | null = null;\n      try {\n        parsed = JSON.parse(raw) as GenericSearchPayload;\n      } catch {\n        parsed = null;\n      }\n\n      if (!response.ok) {\n        throw new Error(parsed?.error || raw || `Search adapter request failed (${response.status})`);\n      }\n\n      const byResults = Array.isArray(parsed?.results) ? parsed?.results : [];\n      if (byResults.length > 0) {\n        return sanitizeResults(byResults);\n      }\n\n      const byItems = Array.isArray(parsed?.items)\n        ? parsed.items.map((item) => ({\n            title: item.title || \"Untitled\",\n            snippet: item.snippet || \"\",\n            url: item.url || item.link || \"#\",\n          }))\n        : [];\n\n      return sanitizeResults(byItems);\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(\"Search adapter timed out.\");\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n"],"mappings":"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","names":["unique"]}

package/dist/index.d.cts

@@ -0,0 +1,193 @@
+type DeepResearchDepth = "standard" | "deep" | "extreme";
+type DeepResearchStage = "planning" | "retrieving" | "ranking" | "verifying" | "synthesizing" | "critiquing";
+type LlmProviderId = "openrouter" | "nim" | "fallback";
+type DeepResearchProgress = {
+    stage: DeepResearchStage;
+    message: string;
+    completed: number;
+    total: number;
+};
+type SearchResult = {
+    title: string;
+    snippet: string;
+    url: string;
+};
+type SearchConstraints = {
+    requiredDomains: string[];
+    preferredDomains: string[];
+    enforceRequiredDomains: boolean;
+    forumHints: string[];
+};
+type SearchOptions = {
+    sites?: string[];
+    preferredSites?: string[];
+    enforceSites?: boolean;
+    forumHints?: string[];
+};
+interface SearchAdapter {
+    search(query: string, options: SearchOptions): Promise<SearchResult[]>;
+}
+interface LlmAdapter {
+    provider: LlmProviderId;
+    complete(prompt: string): Promise<string>;
+}
+type PlannedQuery = {
+    query: string;
+    intent: string;
+    constrainedToDomain?: string;
+};
+type RankedSource = {
+    id: number;
+    title: string;
+    snippet: string;
+    url: string;
+    domain: string;
+    score: number;
+    retrievedFrom: string;
+};
+type ClaimCluster = {
+    claim: string;
+    citationIds: number[];
+    domains: string[];
+    confidence: "high" | "medium" | "low";
+};
+type DeepResearchRun = {
+    query: string;
+    depth: DeepResearchDepth;
+    plan: PlannedQuery[];
+    retrievalRounds: number;
+    rankedSources: RankedSource[];
+    claims: ClaimCluster[];
+    contradictions: string[];
+    unresolvedQuestions: string[];
+    promptContext: string;
+    finalAnswer: string;
+    synthesis: {
+        provider: LlmProviderId;
+        critiqueViolations: string[];
+    };
+    constraints: SearchConstraints;
+    sourcesForMessage: SearchResult[];
+};
+type DeepResearchRunOptions = {
+    depth?: DeepResearchDepth;
+    providerHint?: LlmProviderId;
+    constraints?: Partial<SearchConstraints>;
+    contextBlocks?: string[];
+    onProgress?: (progress: DeepResearchProgress) => void;
+};
+type DeepResearchEngineConfig = {
+    searchAdapter: SearchAdapter;
+    llmAdapters: Partial<Record<LlmProviderId, LlmAdapter>>;
+    defaultProvider: LlmProviderId;
+};
+
+declare const normalizeDomain: (value: string) => string;
+declare const extractSiteTokens: (query: string) => string[];
+declare const extractSearchConstraints: (query: string) => SearchConstraints;
+declare const domainMatches: (urlOrDomain: string, targetDomains: string[]) => boolean;
+declare const mergeConstraints: (base: SearchConstraints, incoming?: Partial<SearchConstraints>) => SearchConstraints;
+
+type TruthContractStrictness = "standard" | "strict";
+type TruthContractCheck = {
+    passed: boolean;
+    violations: string[];
+};
+declare const buildTruthContractInstruction: (strictness: TruthContractStrictness) => string;
+declare const evaluateTruthContract: (response: string, options?: {
+    requiresCitations?: boolean;
+    strictness?: TruthContractStrictness;
+}) => TruthContractCheck;
+
+declare class OpenDeepResearchEngine {
+    private readonly config;
+    private readonly resultCache;
+    constructor(config: DeepResearchEngineConfig);
+    private emit;
+    private buildPlan;
+    private buildRefinementQueries;
+    private retrieveWithCache;
+    private rank;
+    private verify;
+    private buildPromptContext;
+    private synthesize;
+    run(query: string, options?: DeepResearchRunOptions): Promise<DeepResearchRun>;
+}
+
+type OpenRouterAdapterConfig = {
+    apiKey: string;
+    model: string;
+    endpoint?: string;
+    siteUrl?: string;
+    siteName?: string;
+    timeoutMs?: number;
+};
+declare class OpenRouterAdapter implements LlmAdapter {
+    private readonly config;
+    provider: "openrouter";
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly siteUrl;
+    private readonly siteName;
+    constructor(config: OpenRouterAdapterConfig);
+    complete(prompt: string): Promise<string>;
+}
+
+type NimAdapterConfig = {
+    apiKey: string;
+    model: string;
+    endpoint?: string;
+    timeoutMs?: number;
+    maxTokens?: number;
+    temperature?: number;
+};
+declare class NimAdapter implements LlmAdapter {
+    private readonly config;
+    provider: "nim";
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly maxTokens;
+    private readonly temperature;
+    constructor(config: NimAdapterConfig);
+    complete(prompt: string): Promise<string>;
+}
+
+type FunctionAdapterConfig = {
+    provider: LlmProviderId;
+    complete: (prompt: string) => Promise<string>;
+};
+declare class FunctionLlmAdapter implements LlmAdapter {
+    private readonly config;
+    provider: LlmProviderId;
+    constructor(config: FunctionAdapterConfig);
+    complete(prompt: string): Promise<string>;
+}
+
+type HttpJsonSearchAdapterConfig = {
+    endpoint: string;
+    method?: "GET" | "POST";
+    apiKey?: string;
+    apiKeyHeader?: string;
+    timeoutMs?: number;
+    extraHeaders?: Record<string, string>;
+    staticPayload?: Record<string, unknown>;
+};
+declare class HttpJsonSearchAdapter implements SearchAdapter {
+    private readonly config;
+    private readonly method;
+    private readonly timeoutMs;
+    private readonly apiKeyHeader;
+    constructor(config: HttpJsonSearchAdapterConfig);
+    search(query: string, options: SearchOptions): Promise<SearchResult[]>;
+}
+
+type CreateEngineOptions = {
+    searchAdapter: SearchAdapter;
+    defaultProvider?: LlmProviderId;
+    openRouter?: OpenRouterAdapterConfig;
+    nim?: NimAdapterConfig;
+    fallbackComplete?: (prompt: string) => Promise<string>;
+};
+declare const createOpenDeepResearchEngine: (options: CreateEngineOptions) => OpenDeepResearchEngine;
+
+export { type ClaimCluster, type CreateEngineOptions, type DeepResearchDepth, type DeepResearchEngineConfig, type DeepResearchProgress, type DeepResearchRun, type DeepResearchRunOptions, type DeepResearchStage, type FunctionAdapterConfig, FunctionLlmAdapter, HttpJsonSearchAdapter, type HttpJsonSearchAdapterConfig, type LlmAdapter, type LlmProviderId, NimAdapter, type NimAdapterConfig, OpenDeepResearchEngine, OpenRouterAdapter, type OpenRouterAdapterConfig, type PlannedQuery, type RankedSource, type SearchAdapter, type SearchConstraints, type SearchOptions, type SearchResult, type TruthContractCheck, type TruthContractStrictness, buildTruthContractInstruction, createOpenDeepResearchEngine, domainMatches, evaluateTruthContract, extractSearchConstraints, extractSiteTokens, mergeConstraints, normalizeDomain };

package/dist/index.d.ts

@@ -0,0 +1,193 @@
+type DeepResearchDepth = "standard" | "deep" | "extreme";
+type DeepResearchStage = "planning" | "retrieving" | "ranking" | "verifying" | "synthesizing" | "critiquing";
+type LlmProviderId = "openrouter" | "nim" | "fallback";
+type DeepResearchProgress = {
+    stage: DeepResearchStage;
+    message: string;
+    completed: number;
+    total: number;
+};
+type SearchResult = {
+    title: string;
+    snippet: string;
+    url: string;
+};
+type SearchConstraints = {
+    requiredDomains: string[];
+    preferredDomains: string[];
+    enforceRequiredDomains: boolean;
+    forumHints: string[];
+};
+type SearchOptions = {
+    sites?: string[];
+    preferredSites?: string[];
+    enforceSites?: boolean;
+    forumHints?: string[];
+};
+interface SearchAdapter {
+    search(query: string, options: SearchOptions): Promise<SearchResult[]>;
+}
+interface LlmAdapter {
+    provider: LlmProviderId;
+    complete(prompt: string): Promise<string>;
+}
+type PlannedQuery = {
+    query: string;
+    intent: string;
+    constrainedToDomain?: string;
+};
+type RankedSource = {
+    id: number;
+    title: string;
+    snippet: string;
+    url: string;
+    domain: string;
+    score: number;
+    retrievedFrom: string;
+};
+type ClaimCluster = {
+    claim: string;
+    citationIds: number[];
+    domains: string[];
+    confidence: "high" | "medium" | "low";
+};
+type DeepResearchRun = {
+    query: string;
+    depth: DeepResearchDepth;
+    plan: PlannedQuery[];
+    retrievalRounds: number;
+    rankedSources: RankedSource[];
+    claims: ClaimCluster[];
+    contradictions: string[];
+    unresolvedQuestions: string[];
+    promptContext: string;
+    finalAnswer: string;
+    synthesis: {
+        provider: LlmProviderId;
+        critiqueViolations: string[];
+    };
+    constraints: SearchConstraints;
+    sourcesForMessage: SearchResult[];
+};
+type DeepResearchRunOptions = {
+    depth?: DeepResearchDepth;
+    providerHint?: LlmProviderId;
+    constraints?: Partial<SearchConstraints>;
+    contextBlocks?: string[];
+    onProgress?: (progress: DeepResearchProgress) => void;
+};
+type DeepResearchEngineConfig = {
+    searchAdapter: SearchAdapter;
+    llmAdapters: Partial<Record<LlmProviderId, LlmAdapter>>;
+    defaultProvider: LlmProviderId;
+};
+
+declare const normalizeDomain: (value: string) => string;
+declare const extractSiteTokens: (query: string) => string[];
+declare const extractSearchConstraints: (query: string) => SearchConstraints;
+declare const domainMatches: (urlOrDomain: string, targetDomains: string[]) => boolean;
+declare const mergeConstraints: (base: SearchConstraints, incoming?: Partial<SearchConstraints>) => SearchConstraints;
+
+type TruthContractStrictness = "standard" | "strict";
+type TruthContractCheck = {
+    passed: boolean;
+    violations: string[];
+};
+declare const buildTruthContractInstruction: (strictness: TruthContractStrictness) => string;
+declare const evaluateTruthContract: (response: string, options?: {
+    requiresCitations?: boolean;
+    strictness?: TruthContractStrictness;
+}) => TruthContractCheck;
+
+declare class OpenDeepResearchEngine {
+    private readonly config;
+    private readonly resultCache;
+    constructor(config: DeepResearchEngineConfig);
+    private emit;
+    private buildPlan;
+    private buildRefinementQueries;
+    private retrieveWithCache;
+    private rank;
+    private verify;
+    private buildPromptContext;
+    private synthesize;
+    run(query: string, options?: DeepResearchRunOptions): Promise<DeepResearchRun>;
+}
+
+type OpenRouterAdapterConfig = {
+    apiKey: string;
+    model: string;
+    endpoint?: string;
+    siteUrl?: string;
+    siteName?: string;
+    timeoutMs?: number;
+};
+declare class OpenRouterAdapter implements LlmAdapter {
+    private readonly config;
+    provider: "openrouter";
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly siteUrl;
+    private readonly siteName;
+    constructor(config: OpenRouterAdapterConfig);
+    complete(prompt: string): Promise<string>;
+}
+
+type NimAdapterConfig = {
+    apiKey: string;
+    model: string;
+    endpoint?: string;
+    timeoutMs?: number;
+    maxTokens?: number;
+    temperature?: number;
+};
+declare class NimAdapter implements LlmAdapter {
+    private readonly config;
+    provider: "nim";
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly maxTokens;
+    private readonly temperature;
+    constructor(config: NimAdapterConfig);
+    complete(prompt: string): Promise<string>;
+}
+
+type FunctionAdapterConfig = {
+    provider: LlmProviderId;
+    complete: (prompt: string) => Promise<string>;
+};
+declare class FunctionLlmAdapter implements LlmAdapter {
+    private readonly config;
+    provider: LlmProviderId;
+    constructor(config: FunctionAdapterConfig);
+    complete(prompt: string): Promise<string>;
+}
+
+type HttpJsonSearchAdapterConfig = {
+    endpoint: string;
+    method?: "GET" | "POST";
+    apiKey?: string;
+    apiKeyHeader?: string;
+    timeoutMs?: number;
+    extraHeaders?: Record<string, string>;
+    staticPayload?: Record<string, unknown>;
+};
+declare class HttpJsonSearchAdapter implements SearchAdapter {
+    private readonly config;
+    private readonly method;
+    private readonly timeoutMs;
+    private readonly apiKeyHeader;
+    constructor(config: HttpJsonSearchAdapterConfig);
+    search(query: string, options: SearchOptions): Promise<SearchResult[]>;
+}
+
+type CreateEngineOptions = {
+    searchAdapter: SearchAdapter;
+    defaultProvider?: LlmProviderId;
+    openRouter?: OpenRouterAdapterConfig;
+    nim?: NimAdapterConfig;
+    fallbackComplete?: (prompt: string) => Promise<string>;
+};
+declare const createOpenDeepResearchEngine: (options: CreateEngineOptions) => OpenDeepResearchEngine;
+
+export { type ClaimCluster, type CreateEngineOptions, type DeepResearchDepth, type DeepResearchEngineConfig, type DeepResearchProgress, type DeepResearchRun, type DeepResearchRunOptions, type DeepResearchStage, type FunctionAdapterConfig, FunctionLlmAdapter, HttpJsonSearchAdapter, type HttpJsonSearchAdapterConfig, type LlmAdapter, type LlmProviderId, NimAdapter, type NimAdapterConfig, OpenDeepResearchEngine, OpenRouterAdapter, type OpenRouterAdapterConfig, type PlannedQuery, type RankedSource, type SearchAdapter, type SearchConstraints, type SearchOptions, type SearchResult, type TruthContractCheck, type TruthContractStrictness, buildTruthContractInstruction, createOpenDeepResearchEngine, domainMatches, evaluateTruthContract, extractSearchConstraints, extractSiteTokens, mergeConstraints, normalizeDomain };