wauldo 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -340,6 +340,30 @@ interface FactCheckResponse {
     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>;
@@ -514,6 +538,19 @@ declare class HttpClient {
      * ```
      */
     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>;
 }
 
 /**
@@ -634,4 +671,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 ClaimResult, type ClientOptions, type Concept, type ConceptResult, ConnectionError, Conversation, type DetailLevel, 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 SourceType, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, ValidationError, WauldoError, chatContent };
+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 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, ValidationError, type VerifyCitationRequest, type VerifyCitationResponse, WauldoError, chatContent };

package/dist/index.d.ts

@@ -340,6 +340,30 @@ interface FactCheckResponse {
     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>;
@@ -514,6 +538,19 @@ declare class HttpClient {
      * ```
      */
     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>;
 }
 
 /**
@@ -634,4 +671,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 ClaimResult, type ClientOptions, type Concept, type ConceptResult, ConnectionError, Conversation, type DetailLevel, 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 SourceType, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, ValidationError, WauldoError, chatContent };
+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 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, ValidationError, type VerifyCitationRequest, type VerifyCitationResponse, WauldoError, chatContent };

package/dist/index.js

@@ -1123,6 +1123,27 @@ var HttpClient = class {
     );
     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

@@ -1087,6 +1087,27 @@ var HttpClient = class {
     );
     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.2.0",
+  "version": "0.3.0",
   "description": "Official TypeScript SDK for Wauldo — Verified AI answers from your documents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",