wauldo 0.4.0 → 0.5.0

package/README.md

@@ -1,82 +1,129 @@
-# Wauldo TypeScript SDK
+<h1 align="center">Wauldo TypeScript SDK</h1>
 
-[![npm](https://img.shields.io/npm/v/wauldo.svg)](https://npmjs.com/package/wauldo)
-[![Downloads](https://img.shields.io/npm/dm/wauldo.svg)](https://npmjs.com/package/wauldo)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
+<p align="center">
+  <strong>Verified AI answers from your documents — or no answer at all.</strong>
+</p>
 
-> **Verified AI answers from your documents.** Every response includes source citations, confidence scores, and an audit trail — or we don't answer at all.
+<p align="center">
+  Most RAG APIs guess. Wauldo verifies.
+</p>
 
-Official TypeScript SDK for the [Wauldo API](https://wauldo.com) — the AI inference layer with smart model routing, zero hallucinations, and standalone fact-checking.
+<p align="center">
+  <b>0% hallucination</b> &nbsp;|&nbsp; 83% accuracy &nbsp;|&nbsp; 61 eval tasks &nbsp;|&nbsp; 14 LLMs tested
+</p>
 
-## Why Wauldo?
+<p align="center">
+  <a href="https://npmjs.com/package/wauldo"><img src="https://img.shields.io/npm/v/wauldo.svg" alt="npm" /></a>&nbsp;
+  <a href="https://npmjs.com/package/wauldo"><img src="https://img.shields.io/npm/dm/wauldo.svg" alt="Downloads" /></a>&nbsp;
+  <img src="https://img.shields.io/badge/TypeScript-5.0+-blue.svg" alt="TypeScript" />&nbsp;
+  <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT" />
+</p>
 
-- **Native PDF & DOCX Upload** — upload files directly, server-side text extraction with document quality scoring
-- **Citation Verify API** — detect uncited sentences, phantom citations, and measure coverage ratio. No LLM needed
-- **Fact-Check API** — verify any claim against source with 3 modes (lexical, hybrid, semantic). Get verdict, action, and structured reason
-- **Zero hallucinations** — every answer is verified against source documents
-- **Smart model routing** — auto-selects the cheapest model that meets quality (save 40-80% on AI costs)
-- **One API, 7+ providers** — OpenAI, Anthropic, Google, Qwen, Meta, Mistral, DeepSeek with automatic fallback
-- **OpenAI-compatible** — swap your `baseUrl`, keep your existing code
-- **Full audit trail** — confidence score, grounded status, model used, latency on every response
-- **Zero dependencies** — uses Node 18+ built-in APIs (fetch, ReadableStream)
+<p align="center">
+  <a href="https://wauldo.com/demo">Demo</a> &bull;
+  <a href="https://wauldo.com/docs">Docs</a> &bull;
+  <a href="https://rapidapi.com/binnewzzin/api/smart-rag-api">Free API Key</a> &bull;
+  <a href="https://dev.to/wauldo/how-we-achieved-0-hallucination-rate-in-our-rag-api-with-benchmarks-4g54">Benchmarks</a>
+</p>
+
+---
+
+## Quickstart (30 seconds)
 
-## Quick Start
+```bash
+npm install wauldo
+```
 
 ```typescript
 import { HttpClient } from 'wauldo';
 
 const client = new HttpClient({ baseUrl: 'https://api.wauldo.com', apiKey: 'YOUR_API_KEY' });
 
-const reply = await client.chatSimple('auto', 'What is TypeScript?');
-console.log(reply);
+// Upload a document
+await client.ragUpload('Our refund policy allows returns within 60 days...', 'policy.txt');
+
+// Ask a question — answer is verified against the source
+const result = await client.ragQuery('What is the refund policy?');
+console.log(result.answer);
+console.log(result.sources);
 ```
 
-## Installation
+```
+Output:
+Answer: Returns are accepted within 60 days of purchase.
+Sources: policy.txt — "Our refund policy allows returns within 60 days"
+Grounded: true | Confidence: 0.92
+```
 
-```bash
-npm install wauldo
+[Try the demo](https://wauldo.com/demo) | [Get a free API key](https://rapidapi.com/binnewzzin/api/smart-rag-api)
+
+---
+
+## Why Wauldo (and not standard RAG)
+
+**Typical RAG pipeline**
+
+```
+retrieve → generate → hope it's correct
 ```
 
-**Requirements:** Node.js 18+, TypeScript 5.0+
+**Wauldo pipeline**
 
-## Features
+```
+retrieve → extract facts → generate → verify → return or refuse
+```
 
-### Chat Completions
+If the answer can't be verified, it returns **"insufficient evidence"** instead of guessing.
 
-```typescript
-import { HttpClient } from 'wauldo';
+### See the difference
 
-const client = new HttpClient({ baseUrl: 'https://api.wauldo.com', apiKey: 'YOUR_API_KEY' });
+```
+Document: "Refunds are processed within 60 days"
 
-const response = await client.chat({
-  model: 'auto',
-  messages: [
-    { role: 'system', content: 'You are a helpful assistant.' },
-    { role: 'user', content: 'Explain async/await in TypeScript' },
-  ],
-});
-console.log(response.choices[0]?.message?.content);
+Typical RAG:  "Refunds are processed within 30 days"     ← wrong
+Wauldo:       "Refunds are processed within 60 days"     ← verified
+              or "insufficient evidence" if unclear       ← safe
 ```
 
-### RAG — Upload & Query
+---
+
+## Examples
+
+### Upload a PDF and ask questions
 
 ```typescript
-// Upload a document
-const upload = await client.ragUpload('Contract text here...', 'contract.txt');
-console.log(`Indexed ${upload.chunks_count} chunks`);
+// Upload — text extraction + quality scoring happens server-side
+const upload = await client.uploadFile(filePath, { title: 'Q3 Contract' });
+console.log(`Extracted ${upload.chunks_count} chunks, quality: ${upload.quality_label}`);
 
-// Query with verified answer
+// Query
 const result = await client.ragQuery('What are the payment terms?');
 console.log(`Answer: ${result.answer}`);
 console.log(`Confidence: ${Math.round(result.audit.confidence * 100)}%`);
 console.log(`Grounded: ${result.audit.grounded}`);
-for (const source of result.sources) {
-  console.log(`  Source (${Math.round(source.score * 100)}%): ${source.content}`);
-}
 ```
 
-### Streaming (SSE)
+### Fact-check any LLM output
+
+```typescript
+const result = await client.factCheck({
+  text: 'Returns are accepted within 60 days.',
+  sourceContext: 'Our policy allows returns within 14 days.',
+  mode: 'lexical',
+});
+console.log(result.verdict);          // "rejected"
+console.log(result.action);           // "block"
+console.log(result.claims[0].reason); // "numerical_mismatch"
+```
+
+### Chat (OpenAI-compatible)
+
+```typescript
+const reply = await client.chatSimple('auto', 'Explain async/await in TypeScript');
+console.log(reply);
+```
+
+### Streaming
 
 ```typescript
 const stream = client.chatStream({
@@ -88,7 +135,7 @@ for await (const chunk of stream) {
 }
 ```
 
-### Conversation Helper
+### Conversation
 
 ```typescript
 const conv = client.conversation({ system: 'You are an expert on TypeScript.', model: 'auto' });
@@ -96,18 +143,20 @@ const reply = await conv.say('What are generics?');
 const followUp = await conv.say('Give me an example');
 ```
 
-### Fact-Check — Verify Claims
+---
 
-```typescript
-const result = await client.factCheck({
-  text: 'Returns are accepted within 60 days.',
-  source_context: 'Our policy allows returns within 14 days.',
-  mode: 'lexical',
-});
-console.log(result.verdict); // "rejected"
-console.log(result.action);  // "block"
-result.claims.forEach(c => console.log(`${c.text} → ${c.verdict} (${c.reason})`));
-```
+## Features
+
+- **Pre-generation fact extraction** — numbers, dates, limits injected as constraints
+- **Post-generation grounding check** — every answer verified against sources
+- **Citation validation** — detects phantom references
+- **Fact-check API** — verify any claim against any source (3 modes)
+- **Native PDF/DOCX upload** — server-side extraction with quality scoring
+- **Smart model routing** — auto-selects cheapest model that meets quality
+- **OpenAI-compatible** — swap your `baseUrl`, keep your existing code
+- **Zero dependencies** — uses Node 18+ built-in APIs (fetch, ReadableStream)
+
+---
 
 ## Error Handling
 
@@ -115,19 +164,16 @@ result.claims.forEach(c => console.log(`${c.text} → ${c.verdict} (${c.reason})
 import { HttpClient, ServerError } from 'wauldo';
 
 try {
-  const response = await client.chat({
-    model: 'auto',
-    messages: [{ role: 'user', content: 'Hello' }],
-  });
+  const response = await client.chat({ model: 'auto', messages: [{ role: 'user', content: 'Hello' }] });
 } catch (error) {
   if (error instanceof ServerError) {
     console.error(`Server error [${error.code}]: ${error.message}`);
-  } else {
-    console.error('Unknown error:', error);
   }
 }
 ```
 
+---
+
 ## RapidAPI
 
 ```typescript
@@ -140,19 +186,15 @@ const client = new HttpClient({
 });
 ```
 
-Get your free API key (300 req/month): [RapidAPI](https://rapidapi.com/binnewzzin/api/smart-rag-api)
+Free tier (300 req/month): [RapidAPI](https://rapidapi.com/binnewzzin/api/smart-rag-api)
 
-## Links
+---
 
-- [Website](https://wauldo.com)
-- [Documentation](https://wauldo.com/docs)
-- [Live Demo](https://api.wauldo.com/demo)
-- [Cost Calculator](https://wauldo.com/calculator)
-- [Status](https://wauldo.com/status)
+[Website](https://wauldo.com) | [Docs](https://wauldo.com/docs) | [Demo](https://wauldo.com/demo) | [Benchmarks](https://dev.to/wauldo/how-we-achieved-0-hallucination-rate-in-our-rag-api-with-benchmarks-4g54)
 
 ## Contributing
 
-Found a bug? Have a feature request? [Open an issue](https://github.com/wauldo/wauldo-sdk-js/issues).
+PRs welcome. Check the [good first issues](https://github.com/wauldo/wauldo-sdk-js/labels/good%20first%20issue).
 
 ## License
 

package/dist/index.d.mts

@@ -277,22 +277,6 @@ interface RagUploadResponse {
     document_id: string;
     chunks_count: number;
 }
-interface DocumentQuality {
-    score: number;
-    label: string;
-    word_count: number;
-    line_density: number;
-    avg_line_length: number;
-    paragraph_count: number;
-}
-interface UploadFileResponse {
-    document_id: string;
-    chunks_count: number;
-    indexed_at: string;
-    content_type: string;
-    trace_id: string;
-    quality?: DocumentQuality;
-}
 interface RagSource {
     document_id: string;
     content: string;
@@ -328,58 +312,6 @@ interface RagQueryResponse {
 interface OrchestratorResponse {
     final_output: string;
 }
-interface FactCheckRequest {
-    text: string;
-    source_context: string;
-    mode?: 'lexical' | 'hybrid' | 'semantic';
-}
-interface ClaimResult {
-    text: string;
-    claim_type: string;
-    supported: boolean;
-    confidence: number;
-    confidence_label: string;
-    verdict: string;
-    action: string;
-    reason?: string | null;
-    evidence?: string | null;
-}
-interface FactCheckResponse {
-    verdict: string;
-    action: string;
-    hallucination_rate: number;
-    mode: string;
-    total_claims: number;
-    supported_claims: number;
-    confidence: number;
-    claims: ClaimResult[];
-    mode_warning?: string | null;
-    processing_time_ms: number;
-}
-interface SourceChunk {
-    name: string;
-    content: string;
-}
-interface CitationDetail {
-    citation: string;
-    source_name: string;
-    is_valid: boolean;
-}
-interface VerifyCitationRequest {
-    text: string;
-    sources?: SourceChunk[];
-    threshold?: number;
-}
-interface VerifyCitationResponse {
-    citation_ratio: number;
-    has_sufficient_citations: boolean;
-    sentence_count: number;
-    citation_count: number;
-    uncited_sentences: string[];
-    citations?: CitationDetail[];
-    phantom_count?: number;
-    processing_time_ms: number;
-}
 /** Minimal interface required by Conversation — implemented by both HttpClient and MockHttpClient */
 interface ChatClientLike {
     chat(request: ChatRequest, options?: RequestOptions): Promise<ChatResponse>;
@@ -503,19 +435,6 @@ declare class HttpClient {
      * @returns Upload confirmation with document_id and chunks_count
      */
     ragUpload(content: string, filename?: string, options?: RequestOptions): Promise<RagUploadResponse>;
-    /**
-     * POST /v1/upload-file — Upload a file (PDF, DOCX, text, image) for RAG indexing.
-     *
-     * @param file - File content as Buffer/Uint8Array
-     * @param filename - The filename (determines content type detection)
-     * @param options - Optional title, tags, timeoutMs
-     * @returns Upload confirmation with quality scoring
-     */
-    uploadFile(file: Uint8Array | Buffer, filename: string, options?: {
-        title?: string;
-        tags?: string;
-        timeoutMs?: number;
-    }): Promise<UploadFileResponse>;
     /** POST /v1/query — Query RAG knowledge base */
     ragQuery(query: string, topK?: number, options?: {
         debug?: boolean;
@@ -550,36 +469,6 @@ declare class HttpClient {
     orchestrate(prompt: string): Promise<OrchestratorResponse>;
     /** POST /v1/orchestrator/parallel — Run all 4 specialists in parallel */
     orchestrateParallel(prompt: string): Promise<OrchestratorResponse>;
-    /**
-     * POST /v1/fact-check — Verify claims against source context.
-     *
-     * @param request - Text and source context to verify
-     * @returns FactCheckResponse with verdict, action, and per-claim results
-     *
-     * @example
-     * ```typescript
-     * const result = await client.factCheck({
-     *   text: 'Returns accepted within 60 days.',
-     *   source_context: 'Our policy allows returns within 14 days.',
-     *   mode: 'lexical',
-     * });
-     * console.log(result.verdict); // "rejected"
-     * ```
-     */
-    factCheck(request: FactCheckRequest): Promise<FactCheckResponse>;
-    /**
-     * POST /v1/verify — Verify citations in AI-generated text.
-     *
-     * @example
-     * ```ts
-     * const result = await client.verifyCitation({
-     *   text: 'Rust was released in 2010 [Source: rust_book].',
-     *   sources: [{ name: 'rust_book', content: 'Rust was first released in 2010.' }],
-     * });
-     * console.log(result.phantom_count); // 0
-     * ```
-     */
-    verifyCitation(request: VerifyCitationRequest): Promise<VerifyCitationResponse>;
 }
 
 /**
@@ -700,4 +589,4 @@ declare class ToolNotFoundError extends WauldoError {
     constructor(toolName: string);
 }
 
-export { AgentClient, type CallToolResponse, type ChatChoice, type ChatClientLike, type ChatMessage, type ChatRequest, type ChatResponse, type ChatUsage, type Chunk, type ChunkResult, type CitationDetail, type ClaimResult, type ClientOptions, type Concept, type ConceptResult, ConnectionError, Conversation, type DetailLevel, type DocumentQuality, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type FactCheckRequest, type FactCheckResponse, type GraphNode, HttpClient, type HttpClientConfig, type KnowledgeGraphResult, type LogLevel, MockHttpClient, type ModelInfo, type ModelList, type OrchestratorResponse, type PlanOptions, type PlanResult, type PlanStep, type RagAuditInfo, type RagQueryResponse, type RagSource, type RagUploadResponse, type ReasoningOptions, type ReasoningResult, type RequestOptions, type RetrievalResult, ServerError, type SourceChunk, type SourceType, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, type UploadFileResponse, ValidationError, type VerifyCitationRequest, type VerifyCitationResponse, WauldoError, chatContent };
+export { AgentClient, type CallToolResponse, type ChatChoice, type ChatClientLike, type ChatMessage, type ChatRequest, type ChatResponse, type ChatUsage, type Chunk, type ChunkResult, type ClientOptions, type Concept, type ConceptResult, ConnectionError, Conversation, type DetailLevel, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type GraphNode, HttpClient, type HttpClientConfig, type KnowledgeGraphResult, type LogLevel, MockHttpClient, type ModelInfo, type ModelList, type OrchestratorResponse, type PlanOptions, type PlanResult, type PlanStep, type RagAuditInfo, type RagQueryResponse, type RagSource, type RagUploadResponse, type ReasoningOptions, type ReasoningResult, type RequestOptions, type RetrievalResult, ServerError, type SourceType, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, ValidationError, WauldoError, chatContent };

package/dist/index.d.ts

@@ -277,22 +277,6 @@ interface RagUploadResponse {
     document_id: string;
     chunks_count: number;
 }
-interface DocumentQuality {
-    score: number;
-    label: string;
-    word_count: number;
-    line_density: number;
-    avg_line_length: number;
-    paragraph_count: number;
-}
-interface UploadFileResponse {
-    document_id: string;
-    chunks_count: number;
-    indexed_at: string;
-    content_type: string;
-    trace_id: string;
-    quality?: DocumentQuality;
-}
 interface RagSource {
     document_id: string;
     content: string;
@@ -328,58 +312,6 @@ interface RagQueryResponse {
 interface OrchestratorResponse {
     final_output: string;
 }
-interface FactCheckRequest {
-    text: string;
-    source_context: string;
-    mode?: 'lexical' | 'hybrid' | 'semantic';
-}
-interface ClaimResult {
-    text: string;
-    claim_type: string;
-    supported: boolean;
-    confidence: number;
-    confidence_label: string;
-    verdict: string;
-    action: string;
-    reason?: string | null;
-    evidence?: string | null;
-}
-interface FactCheckResponse {
-    verdict: string;
-    action: string;
-    hallucination_rate: number;
-    mode: string;
-    total_claims: number;
-    supported_claims: number;
-    confidence: number;
-    claims: ClaimResult[];
-    mode_warning?: string | null;
-    processing_time_ms: number;
-}
-interface SourceChunk {
-    name: string;
-    content: string;
-}
-interface CitationDetail {
-    citation: string;
-    source_name: string;
-    is_valid: boolean;
-}
-interface VerifyCitationRequest {
-    text: string;
-    sources?: SourceChunk[];
-    threshold?: number;
-}
-interface VerifyCitationResponse {
-    citation_ratio: number;
-    has_sufficient_citations: boolean;
-    sentence_count: number;
-    citation_count: number;
-    uncited_sentences: string[];
-    citations?: CitationDetail[];
-    phantom_count?: number;
-    processing_time_ms: number;
-}
 /** Minimal interface required by Conversation — implemented by both HttpClient and MockHttpClient */
 interface ChatClientLike {
     chat(request: ChatRequest, options?: RequestOptions): Promise<ChatResponse>;
@@ -503,19 +435,6 @@ declare class HttpClient {
      * @returns Upload confirmation with document_id and chunks_count
      */
     ragUpload(content: string, filename?: string, options?: RequestOptions): Promise<RagUploadResponse>;
-    /**
-     * POST /v1/upload-file — Upload a file (PDF, DOCX, text, image) for RAG indexing.
-     *
-     * @param file - File content as Buffer/Uint8Array
-     * @param filename - The filename (determines content type detection)
-     * @param options - Optional title, tags, timeoutMs
-     * @returns Upload confirmation with quality scoring
-     */
-    uploadFile(file: Uint8Array | Buffer, filename: string, options?: {
-        title?: string;
-        tags?: string;
-        timeoutMs?: number;
-    }): Promise<UploadFileResponse>;
     /** POST /v1/query — Query RAG knowledge base */
     ragQuery(query: string, topK?: number, options?: {
         debug?: boolean;
@@ -550,36 +469,6 @@ declare class HttpClient {
     orchestrate(prompt: string): Promise<OrchestratorResponse>;
     /** POST /v1/orchestrator/parallel — Run all 4 specialists in parallel */
     orchestrateParallel(prompt: string): Promise<OrchestratorResponse>;
-    /**
-     * POST /v1/fact-check — Verify claims against source context.
-     *
-     * @param request - Text and source context to verify
-     * @returns FactCheckResponse with verdict, action, and per-claim results
-     *
-     * @example
-     * ```typescript
-     * const result = await client.factCheck({
-     *   text: 'Returns accepted within 60 days.',
-     *   source_context: 'Our policy allows returns within 14 days.',
-     *   mode: 'lexical',
-     * });
-     * console.log(result.verdict); // "rejected"
-     * ```
-     */
-    factCheck(request: FactCheckRequest): Promise<FactCheckResponse>;
-    /**
-     * POST /v1/verify — Verify citations in AI-generated text.
-     *
-     * @example
-     * ```ts
-     * const result = await client.verifyCitation({
-     *   text: 'Rust was released in 2010 [Source: rust_book].',
-     *   sources: [{ name: 'rust_book', content: 'Rust was first released in 2010.' }],
-     * });
-     * console.log(result.phantom_count); // 0
-     * ```
-     */
-    verifyCitation(request: VerifyCitationRequest): Promise<VerifyCitationResponse>;
 }
 
 /**
@@ -700,4 +589,4 @@ declare class ToolNotFoundError extends WauldoError {
     constructor(toolName: string);
 }
 
-export { AgentClient, type CallToolResponse, type ChatChoice, type ChatClientLike, type ChatMessage, type ChatRequest, type ChatResponse, type ChatUsage, type Chunk, type ChunkResult, type CitationDetail, type ClaimResult, type ClientOptions, type Concept, type ConceptResult, ConnectionError, Conversation, type DetailLevel, type DocumentQuality, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type FactCheckRequest, type FactCheckResponse, type GraphNode, HttpClient, type HttpClientConfig, type KnowledgeGraphResult, type LogLevel, MockHttpClient, type ModelInfo, type ModelList, type OrchestratorResponse, type PlanOptions, type PlanResult, type PlanStep, type RagAuditInfo, type RagQueryResponse, type RagSource, type RagUploadResponse, type ReasoningOptions, type ReasoningResult, type RequestOptions, type RetrievalResult, ServerError, type SourceChunk, type SourceType, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, type UploadFileResponse, ValidationError, type VerifyCitationRequest, type VerifyCitationResponse, WauldoError, chatContent };
+export { AgentClient, type CallToolResponse, type ChatChoice, type ChatClientLike, type ChatMessage, type ChatRequest, type ChatResponse, type ChatUsage, type Chunk, type ChunkResult, type ClientOptions, type Concept, type ConceptResult, ConnectionError, Conversation, type DetailLevel, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type GraphNode, HttpClient, type HttpClientConfig, type KnowledgeGraphResult, type LogLevel, MockHttpClient, type ModelInfo, type ModelList, type OrchestratorResponse, type PlanOptions, type PlanResult, type PlanStep, type RagAuditInfo, type RagQueryResponse, type RagSource, type RagUploadResponse, type ReasoningOptions, type ReasoningResult, type RequestOptions, type RetrievalResult, ServerError, type SourceType, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, ValidationError, WauldoError, chatContent };

package/dist/index.js

@@ -900,16 +900,6 @@ async function* parseSSEStream(body) {
 }
 
 // src/http_client.ts
-function concatUint8Arrays(arrays) {
-  const total = arrays.reduce((n, a) => n + a.length, 0);
-  const result = new Uint8Array(total);
-  let offset = 0;
-  for (const a of arrays) {
-    result.set(a, offset);
-    offset += a.length;
-  }
-  return result;
-}
 function validateResponse(data, typeName) {
   if (data === null || data === void 0) {
     throw new ServerError(`Invalid ${typeName}: response is null`, 0);
@@ -1044,51 +1034,6 @@ var HttpClient = class {
     );
     return validateResponse(data, "RagUploadResponse");
   }
-  /**
-   * POST /v1/upload-file — Upload a file (PDF, DOCX, text, image) for RAG indexing.
-   *
-   * @param file - File content as Buffer/Uint8Array
-   * @param filename - The filename (determines content type detection)
-   * @param options - Optional title, tags, timeoutMs
-   * @returns Upload confirmation with quality scoring
-   */
-  async uploadFile(file, filename, options) {
-    const boundary = "----WauldoSDKBoundary";
-    const parts = [];
-    const enc = new TextEncoder();
-    parts.push(enc.encode(`--${boundary}\r
-Content-Disposition: form-data; name="file"; filename="${filename}"\r
-Content-Type: application/octet-stream\r
-\r
-`));
-    parts.push(file instanceof Uint8Array ? file : new Uint8Array(file));
-    parts.push(enc.encode("\r\n"));
-    if (options?.title) {
-      parts.push(enc.encode(`--${boundary}\r
-Content-Disposition: form-data; name="title"\r
-\r
-${options.title}\r
-`));
-    }
-    if (options?.tags) {
-      parts.push(enc.encode(`--${boundary}\r
-Content-Disposition: form-data; name="tags"\r
-\r
-${options.tags}\r
-`));
-    }
-    parts.push(enc.encode(`--${boundary}--\r
-`));
-    const body = concatUint8Arrays(parts);
-    const data = await fetchWithRetry(
-      { ...this.retryConfig, headers: { ...this.retryConfig.headers, "Content-Type": `multipart/form-data; boundary=${boundary}` } },
-      "POST",
-      "/v1/upload-file",
-      body,
-      options?.timeoutMs
-    );
-    return validateResponse(data, "UploadFileResponse");
-  }
   /** POST /v1/query — Query RAG knowledge base */
   async ragQuery(query, topK = 5, options) {
     const body = { query, top_k: topK };
@@ -1152,53 +1097,6 @@ ${options.tags}\r
     );
     return validateResponse(data, "OrchestratorResponse");
   }
-  // ── Fact-Check endpoints ──────────────────────────────────────────────
-  /**
-   * POST /v1/fact-check — Verify claims against source context.
-   *
-   * @param request - Text and source context to verify
-   * @returns FactCheckResponse with verdict, action, and per-claim results
-   *
-   * @example
-   * ```typescript
-   * const result = await client.factCheck({
-   *   text: 'Returns accepted within 60 days.',
-   *   source_context: 'Our policy allows returns within 14 days.',
-   *   mode: 'lexical',
-   * });
-   * console.log(result.verdict); // "rejected"
-   * ```
-   */
-  async factCheck(request) {
-    const data = await fetchWithRetry(
-      this.retryConfig,
-      "POST",
-      "/v1/fact-check",
-      request
-    );
-    return validateResponse(data, "FactCheckResponse");
-  }
-  /**
-   * POST /v1/verify — Verify citations in AI-generated text.
-   *
-   * @example
-   * ```ts
-   * const result = await client.verifyCitation({
-   *   text: 'Rust was released in 2010 [Source: rust_book].',
-   *   sources: [{ name: 'rust_book', content: 'Rust was first released in 2010.' }],
-   * });
-   * console.log(result.phantom_count); // 0
-   * ```
-   */
-  async verifyCitation(request) {
-    const data = await fetchWithRetry(
-      this.retryConfig,
-      "POST",
-      "/v1/verify",
-      request
-    );
-    return validateResponse(data, "VerifyCitationResponse");
-  }
 };
 
 // src/mock_client.ts

package/dist/index.mjs

@@ -864,16 +864,6 @@ async function* parseSSEStream(body) {
 }
 
 // src/http_client.ts
-function concatUint8Arrays(arrays) {
-  const total = arrays.reduce((n, a) => n + a.length, 0);
-  const result = new Uint8Array(total);
-  let offset = 0;
-  for (const a of arrays) {
-    result.set(a, offset);
-    offset += a.length;
-  }
-  return result;
-}
 function validateResponse(data, typeName) {
   if (data === null || data === void 0) {
     throw new ServerError(`Invalid ${typeName}: response is null`, 0);
@@ -1008,51 +998,6 @@ var HttpClient = class {
     );
     return validateResponse(data, "RagUploadResponse");
   }
-  /**
-   * POST /v1/upload-file — Upload a file (PDF, DOCX, text, image) for RAG indexing.
-   *
-   * @param file - File content as Buffer/Uint8Array
-   * @param filename - The filename (determines content type detection)
-   * @param options - Optional title, tags, timeoutMs
-   * @returns Upload confirmation with quality scoring
-   */
-  async uploadFile(file, filename, options) {
-    const boundary = "----WauldoSDKBoundary";
-    const parts = [];
-    const enc = new TextEncoder();
-    parts.push(enc.encode(`--${boundary}\r
-Content-Disposition: form-data; name="file"; filename="${filename}"\r
-Content-Type: application/octet-stream\r
-\r
-`));
-    parts.push(file instanceof Uint8Array ? file : new Uint8Array(file));
-    parts.push(enc.encode("\r\n"));
-    if (options?.title) {
-      parts.push(enc.encode(`--${boundary}\r
-Content-Disposition: form-data; name="title"\r
-\r
-${options.title}\r
-`));
-    }
-    if (options?.tags) {
-      parts.push(enc.encode(`--${boundary}\r
-Content-Disposition: form-data; name="tags"\r
-\r
-${options.tags}\r
-`));
-    }
-    parts.push(enc.encode(`--${boundary}--\r
-`));
-    const body = concatUint8Arrays(parts);
-    const data = await fetchWithRetry(
-      { ...this.retryConfig, headers: { ...this.retryConfig.headers, "Content-Type": `multipart/form-data; boundary=${boundary}` } },
-      "POST",
-      "/v1/upload-file",
-      body,
-      options?.timeoutMs
-    );
-    return validateResponse(data, "UploadFileResponse");
-  }
   /** POST /v1/query — Query RAG knowledge base */
   async ragQuery(query, topK = 5, options) {
     const body = { query, top_k: topK };
@@ -1116,53 +1061,6 @@ ${options.tags}\r
     );
     return validateResponse(data, "OrchestratorResponse");
   }
-  // ── Fact-Check endpoints ──────────────────────────────────────────────
-  /**
-   * POST /v1/fact-check — Verify claims against source context.
-   *
-   * @param request - Text and source context to verify
-   * @returns FactCheckResponse with verdict, action, and per-claim results
-   *
-   * @example
-   * ```typescript
-   * const result = await client.factCheck({
-   *   text: 'Returns accepted within 60 days.',
-   *   source_context: 'Our policy allows returns within 14 days.',
-   *   mode: 'lexical',
-   * });
-   * console.log(result.verdict); // "rejected"
-   * ```
-   */
-  async factCheck(request) {
-    const data = await fetchWithRetry(
-      this.retryConfig,
-      "POST",
-      "/v1/fact-check",
-      request
-    );
-    return validateResponse(data, "FactCheckResponse");
-  }
-  /**
-   * POST /v1/verify — Verify citations in AI-generated text.
-   *
-   * @example
-   * ```ts
-   * const result = await client.verifyCitation({
-   *   text: 'Rust was released in 2010 [Source: rust_book].',
-   *   sources: [{ name: 'rust_book', content: 'Rust was first released in 2010.' }],
-   * });
-   * console.log(result.phantom_count); // 0
-   * ```
-   */
-  async verifyCitation(request) {
-    const data = await fetchWithRetry(
-      this.retryConfig,
-      "POST",
-      "/v1/verify",
-      request
-    );
-    return validateResponse(data, "VerifyCitationResponse");
-  }
 };
 
 // src/mock_client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wauldo",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Official TypeScript SDK for Wauldo — Verified AI answers from your documents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",