wauldo 0.7.0 → 0.7.2

package/README.md

@@ -28,35 +28,12 @@
 
 ---
 
-## Try it locally (no server needed)
+## Quickstart (30 seconds)
 
 ```bash
 npm install wauldo
 ```
 
-```typescript
-import { MockHttpClient } from 'wauldo';
-
-const client = new MockHttpClient();
-
-// Upload, query, fact-check — all offline
-await client.ragUpload('Refund policy allows returns within 60 days.', 'policy.txt');
-const result = await client.ragQuery('What is the refund policy?');
-console.log(result.answer); // "Mock answer for: What is the refund policy?"
-
-const check = await client.factCheck({
-  text: 'Returns accepted within 30 days.',
-  source_context: 'Refund policy allows returns within 60 days.',
-});
-console.log(check.verdict); // "rejected"
-```
-
-Run the full quickstart: `npx tsx examples/quickstart.ts`
-
----
-
-## Quickstart with real API
-
 ```typescript
 import { HttpClient } from 'wauldo';
 
@@ -126,14 +103,14 @@ console.log(`Confidence: ${Math.round(result.audit.confidence * 100)}%`);
 console.log(`Grounded: ${result.audit.grounded}`);
 ```
 
-### Fact-check any LLM output
+### Guard — 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',
-});
+const result = await client.guard(
+  'Returns are accepted within 60 days.',
+  'Our policy allows returns within 14 days.',
+  'lexical',
+);
 console.log(result.verdict);          // "rejected"
 console.log(result.action);           // "block"
 console.log(result.claims[0].reason); // "numerical_mismatch"
@@ -172,10 +149,7 @@ const followUp = await conv.say('Give me an example');
 
 - **Pre-generation fact extraction** — numbers, dates, limits injected as constraints
 - **Post-generation grounding check** — every answer verified against sources
-- **Citation validation** — detects phantom references
-- **Analytics & Insights** — track token savings, cache performance, cost per hour, and per-tenant traffic
-- **Guard method** — one-call hallucination firewall (`client.guard(text, source)` → safe/unsafe)
-- **Fact-check API** — verify any claim against any source (3 modes)
+- **Guard API** — verify any claim against any source (3 modes: lexical, hybrid, semantic)
 - **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
@@ -219,9 +193,7 @@ Free tier (300 req/month): [RapidAPI](https://rapidapi.com/binnewzzin/api/smart-
 
 ## Contributing
 
-PRs welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions and guidelines.
-
-Check the [good first issues](https://github.com/wauldo/wauldo-sdk-js/labels/good%20first%20issue) to get started.
+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;
@@ -325,69 +309,7 @@ interface RagQueryResponse {
     confidence?: number;
     grounded?: boolean;
 }
-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;
-}
-/** @deprecated Use GuardResponse instead */
-interface GuardResult {
-    safe: boolean;
-    verdict: string;
-    action: string;
-    reason: string | null;
-    confidence: number;
-}
+/** A single verified claim from the Guard response */
 interface GuardClaim {
     text: string;
     claim_type?: string;
@@ -399,6 +321,7 @@ interface GuardClaim {
     reason?: string | null;
     evidence?: string | null;
 }
+/** Response from POST /v1/fact-check — the Guard verification API */
 interface GuardResponse {
     verdict: string;
     action: string;
@@ -411,51 +334,14 @@ interface GuardResponse {
     mode_warning?: string;
     processing_time_ms?: number;
 }
+/** Check if a GuardResponse allows the content through */
+declare function guardIsSafe(response: GuardResponse): boolean;
+/** Check if a GuardResponse blocks the content */
+declare function guardIsBlocked(response: GuardResponse): boolean;
+/** Guard verification modes */
 type GuardMode = 'lexical' | 'hybrid' | 'semantic';
-interface InsightsResponse {
-    tig_key: string;
-    total_requests: number;
-    intelligence_requests: number;
-    fallback_requests: number;
-    tokens: {
-        baseline_total: number;
-        real_total: number;
-        saved_total: number;
-        saved_percent_avg: number;
-    };
-    cost: {
-        estimated_usd_saved: number;
-    };
-}
-interface AnalyticsResponse {
-    cache: {
-        total_requests: number;
-        cache_hit_rate: number;
-        avg_latency_ms: number;
-        p95_latency_ms: number;
-    };
-    tokens: {
-        total_baseline: number;
-        total_real: number;
-        total_saved: number;
-        avg_savings_percent: number;
-    };
-    uptime_secs: number;
-}
-interface TrafficSummary {
-    total_requests_today: number;
-    total_tokens_today: number;
-    top_tenants: Array<{
-        tenant_id: string;
-        requests_today: number;
-        tokens_used: number;
-        success_rate: number;
-        avg_latency_ms: number;
-    }>;
-    error_rate: number;
-    avg_latency_ms: number;
-    p95_latency_ms: number;
-    uptime_secs: number;
+interface OrchestratorResponse {
+    final_output: string;
 }
 /** Minimal interface required by Conversation — implemented by both HttpClient and MockHttpClient */
 interface ChatClientLike {
@@ -580,19 +466,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;
@@ -623,49 +496,16 @@ declare class HttpClient {
      * @returns The answer string
      */
     ragAsk(question: string, text: string, source?: string): Promise<string>;
-    /** POST /v1/orchestrator/execute — Route to best specialist agent */
-    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>;
     /**
      * POST /v1/fact-check — Verify text claims against source context.
      *
-     * Guard is a hallucination firewall: checks whether LLM output is
-     * supported by source documents. Blocks wrong answers before users see them.
+     * Guard is a hallucination firewall: checks whether LLM output is supported
+     * by source documents. Blocks wrong answers before they reach users.
      *
      * @param text - The LLM-generated text to verify
      * @param sourceContext - The ground-truth source document(s)
      * @param mode - "lexical" (<1ms), "hybrid" (~50ms), or "semantic" (~500ms)
+     * @param options - Optional per-request overrides
      *
      * @example
      * ```typescript
@@ -673,24 +513,16 @@ declare class HttpClient {
      *   'Returns accepted within 60 days',
      *   'Our return policy: 14 days.',
      * );
-     * if (guardIsBlocked(result)) {
+     * if (result.action === 'block') {
      *   console.log('Hallucination caught:', result.claims[0]?.reason);
      * }
      * ```
      */
-    guard(text: string, sourceContext: string, mode?: GuardMode): Promise<GuardResponse>;
-    /**
-     * GET /v1/insights — ROI metrics for your API key
-     */
-    getInsights(): Promise<InsightsResponse>;
-    /**
-     * GET /v1/analytics — Usage analytics and cache performance
-     */
-    getAnalytics(minutes?: number): Promise<AnalyticsResponse>;
-    /**
-     * GET /v1/analytics/traffic — Per-tenant traffic monitoring
-     */
-    getAnalyticsTraffic(): Promise<TrafficSummary>;
+    guard(text: string, sourceContext: string, mode?: GuardMode, options?: RequestOptions): Promise<GuardResponse>;
+    /** POST /v1/orchestrator/execute — Route to best specialist agent */
+    orchestrate(prompt: string): Promise<OrchestratorResponse>;
+    /** POST /v1/orchestrator/parallel — Run all 4 specialists in parallel */
+    orchestrateParallel(prompt: string): Promise<OrchestratorResponse>;
 }
 
 /**
@@ -761,17 +593,7 @@ declare class MockHttpClient {
         system?: string;
         model?: string;
     }): Conversation;
-    uploadFile(_file: Uint8Array | Buffer, filename: string, options?: {
-        title?: string;
-        tags?: string;
-        timeoutMs?: number;
-    }): Promise<UploadFileResponse>;
-    factCheck(request: FactCheckRequest): Promise<FactCheckResponse>;
-    guard(text: string, sourceContext: string, mode?: 'lexical' | 'hybrid' | 'semantic'): Promise<GuardResponse>;
-    verifyCitation(request: VerifyCitationRequest): Promise<VerifyCitationResponse>;
-    getInsights(): Promise<InsightsResponse>;
-    getAnalytics(minutes?: number): Promise<AnalyticsResponse>;
-    getAnalyticsTraffic(): Promise<TrafficSummary>;
+    guard(text: string, sourceContext: string, mode?: GuardMode, _options?: RequestOptions): Promise<GuardResponse>;
     ragAsk(question: string, text: string, source?: string): Promise<string>;
     private record;
 }
@@ -822,4 +644,4 @@ declare class ToolNotFoundError extends WauldoError {
     constructor(toolName: string);
 }
 
-export { AgentClient, type AnalyticsResponse, 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, type GuardResult, HttpClient, type HttpClientConfig, type InsightsResponse, 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 TrafficSummary, 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, type GuardClaim, type GuardMode, type GuardResponse, 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, guardIsBlocked, guardIsSafe };

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;
@@ -325,69 +309,7 @@ interface RagQueryResponse {
     confidence?: number;
     grounded?: boolean;
 }
-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;
-}
-/** @deprecated Use GuardResponse instead */
-interface GuardResult {
-    safe: boolean;
-    verdict: string;
-    action: string;
-    reason: string | null;
-    confidence: number;
-}
+/** A single verified claim from the Guard response */
 interface GuardClaim {
     text: string;
     claim_type?: string;
@@ -399,6 +321,7 @@ interface GuardClaim {
     reason?: string | null;
     evidence?: string | null;
 }
+/** Response from POST /v1/fact-check — the Guard verification API */
 interface GuardResponse {
     verdict: string;
     action: string;
@@ -411,51 +334,14 @@ interface GuardResponse {
     mode_warning?: string;
     processing_time_ms?: number;
 }
+/** Check if a GuardResponse allows the content through */
+declare function guardIsSafe(response: GuardResponse): boolean;
+/** Check if a GuardResponse blocks the content */
+declare function guardIsBlocked(response: GuardResponse): boolean;
+/** Guard verification modes */
 type GuardMode = 'lexical' | 'hybrid' | 'semantic';
-interface InsightsResponse {
-    tig_key: string;
-    total_requests: number;
-    intelligence_requests: number;
-    fallback_requests: number;
-    tokens: {
-        baseline_total: number;
-        real_total: number;
-        saved_total: number;
-        saved_percent_avg: number;
-    };
-    cost: {
-        estimated_usd_saved: number;
-    };
-}
-interface AnalyticsResponse {
-    cache: {
-        total_requests: number;
-        cache_hit_rate: number;
-        avg_latency_ms: number;
-        p95_latency_ms: number;
-    };
-    tokens: {
-        total_baseline: number;
-        total_real: number;
-        total_saved: number;
-        avg_savings_percent: number;
-    };
-    uptime_secs: number;
-}
-interface TrafficSummary {
-    total_requests_today: number;
-    total_tokens_today: number;
-    top_tenants: Array<{
-        tenant_id: string;
-        requests_today: number;
-        tokens_used: number;
-        success_rate: number;
-        avg_latency_ms: number;
-    }>;
-    error_rate: number;
-    avg_latency_ms: number;
-    p95_latency_ms: number;
-    uptime_secs: number;
+interface OrchestratorResponse {
+    final_output: string;
 }
 /** Minimal interface required by Conversation — implemented by both HttpClient and MockHttpClient */
 interface ChatClientLike {
@@ -580,19 +466,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;
@@ -623,49 +496,16 @@ declare class HttpClient {
      * @returns The answer string
      */
     ragAsk(question: string, text: string, source?: string): Promise<string>;
-    /** POST /v1/orchestrator/execute — Route to best specialist agent */
-    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>;
     /**
      * POST /v1/fact-check — Verify text claims against source context.
      *
-     * Guard is a hallucination firewall: checks whether LLM output is
-     * supported by source documents. Blocks wrong answers before users see them.
+     * Guard is a hallucination firewall: checks whether LLM output is supported
+     * by source documents. Blocks wrong answers before they reach users.
      *
      * @param text - The LLM-generated text to verify
      * @param sourceContext - The ground-truth source document(s)
      * @param mode - "lexical" (<1ms), "hybrid" (~50ms), or "semantic" (~500ms)
+     * @param options - Optional per-request overrides
      *
      * @example
      * ```typescript
@@ -673,24 +513,16 @@ declare class HttpClient {
      *   'Returns accepted within 60 days',
      *   'Our return policy: 14 days.',
      * );
-     * if (guardIsBlocked(result)) {
+     * if (result.action === 'block') {
      *   console.log('Hallucination caught:', result.claims[0]?.reason);
      * }
      * ```
      */
-    guard(text: string, sourceContext: string, mode?: GuardMode): Promise<GuardResponse>;
-    /**
-     * GET /v1/insights — ROI metrics for your API key
-     */
-    getInsights(): Promise<InsightsResponse>;
-    /**
-     * GET /v1/analytics — Usage analytics and cache performance
-     */
-    getAnalytics(minutes?: number): Promise<AnalyticsResponse>;
-    /**
-     * GET /v1/analytics/traffic — Per-tenant traffic monitoring
-     */
-    getAnalyticsTraffic(): Promise<TrafficSummary>;
+    guard(text: string, sourceContext: string, mode?: GuardMode, options?: RequestOptions): Promise<GuardResponse>;
+    /** POST /v1/orchestrator/execute — Route to best specialist agent */
+    orchestrate(prompt: string): Promise<OrchestratorResponse>;
+    /** POST /v1/orchestrator/parallel — Run all 4 specialists in parallel */
+    orchestrateParallel(prompt: string): Promise<OrchestratorResponse>;
 }
 
 /**
@@ -761,17 +593,7 @@ declare class MockHttpClient {
         system?: string;
         model?: string;
     }): Conversation;
-    uploadFile(_file: Uint8Array | Buffer, filename: string, options?: {
-        title?: string;
-        tags?: string;
-        timeoutMs?: number;
-    }): Promise<UploadFileResponse>;
-    factCheck(request: FactCheckRequest): Promise<FactCheckResponse>;
-    guard(text: string, sourceContext: string, mode?: 'lexical' | 'hybrid' | 'semantic'): Promise<GuardResponse>;
-    verifyCitation(request: VerifyCitationRequest): Promise<VerifyCitationResponse>;
-    getInsights(): Promise<InsightsResponse>;
-    getAnalytics(minutes?: number): Promise<AnalyticsResponse>;
-    getAnalyticsTraffic(): Promise<TrafficSummary>;
+    guard(text: string, sourceContext: string, mode?: GuardMode, _options?: RequestOptions): Promise<GuardResponse>;
     ragAsk(question: string, text: string, source?: string): Promise<string>;
     private record;
 }
@@ -822,4 +644,4 @@ declare class ToolNotFoundError extends WauldoError {
     constructor(toolName: string);
 }
 
-export { AgentClient, type AnalyticsResponse, 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, type GuardResult, HttpClient, type HttpClientConfig, type InsightsResponse, 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 TrafficSummary, 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, type GuardClaim, type GuardMode, type GuardResponse, 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, guardIsBlocked, guardIsSafe };