wauldo 0.8.0 → 0.10.0

package/README.md

@@ -226,7 +226,7 @@ Free tier (300 req/month): [RapidAPI](https://rapidapi.com/binnewzzin/api/smart-
 
 ## Contributing
 
-PRs welcome. Check the [good first issues](https://github.com/wauldo/wauldo-sdk-js/labels/good%20first%20issue).
+PRs welcome. Check the [good first issues](https://github.com/wauldoai/wauldo-sdk-js/labels/good%20first%20issue).
 
 ## License
 

package/dist/index.d.mts

@@ -716,13 +716,24 @@ interface TaskClaim {
  * Verification block attached to completed tasks. When
  * `verification_source === "prompt_only"` the `confidence` and
  * `hallucination_rate` fields reflect self-consistency only; rely on
- * `verdict` + `trust_score` + `message` as authoritative.
+ * `verdict` + `support_score` (alias `trust_score`) + `message` as authoritative.
+ *
+ * Note: `support_score` is the public name for the same numeric value
+ * the wire protocol calls `trust_score`. The JSON wire field is unchanged
+ * for backward compatibility — use `supportScore(v)` to read the value
+ * by its public name. New code should prefer `support_score`.
  */
 interface TaskVerification {
     verdict: Verdict;
     hallucination_rate: number;
     confidence: number;
     trust_score: number;
+    /**
+     * Public name for `trust_score` (0-1 fraction of claims supported
+     * by the sources). Optional on the wire; always equals `trust_score`
+     * when populated. Prefer the `supportScore()` helper to read it.
+     */
+    support_score?: number;
     verification_source: string;
     claims: TaskClaim[];
     verification_retries: number;
@@ -731,6 +742,13 @@ interface TaskVerification {
     sources_cited?: number[];
     stripped_claims?: string[];
 }
+/**
+ * Read the support score of a verification block. Falls back to
+ * `trust_score` when the optional `support_score` field is absent
+ * (the JSON wire format only emits `trust_score` for backward
+ * compatibility). Always returns the same numeric value either way.
+ */
+declare function supportScore(v: TaskVerification): number;
 /** Full task record returned by `GET /v1/tasks/:id`. */
 interface Task {
     task_id: string;
@@ -783,8 +801,8 @@ declare class AgentsClient {
     get(agentId: string): Promise<DeployedAgent>;
     update(agentId: string, patch: UpdateAgentPatch): Promise<DeployedAgent>;
     delete(agentId: string): Promise<void>;
-    run(agentId: string, input: string, verificationMode?: "strict" | "balanced" | "permissive"): Promise<AgentRunResponse>;
-    a2aInvoke(agentId: string, input: string, trace?: string[], verificationMode?: "strict" | "balanced" | "permissive"): Promise<A2aResponse>;
+    run(agentId: string, input: string, verificationMode?: "strict" | "balanced" | "permissive", factCheckMode?: "lexical" | "hybrid" | "semantic"): Promise<AgentRunResponse>;
+    a2aInvoke(agentId: string, input: string, trace?: string[], verificationMode?: "strict" | "balanced" | "permissive", factCheckMode?: "lexical" | "hybrid" | "semantic"): Promise<A2aResponse>;
     /** `GET /v1/tasks/:id` — fetch the current state of a task. */
     getTask(taskId: string): Promise<Task>;
     /** `DELETE /v1/tasks/:id` — cancel a queued or running task. */
@@ -815,4 +833,4 @@ declare class AgentsClient {
     streamTask(taskId: string): AsyncGenerator<StateTransition>;
 }
 
-export { type A2aResponse, AgentClient, type AgentListResponse, type AgentRunResponse, AgentsClient, type AgentsClientConfig, 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 CreateAgentInput, type DeployedAgent, type DetailLevel, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type GraphNode, type GuardClaim, type GuardMode, type GuardResponse, HttpClient, type HttpClientConfig, HttpError, 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, type StateTransition, type Task, type TaskClaim, type TaskStatus, type TaskVerification, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, type UpdateAgentPatch, ValidationError, type Verdict, WauldoError, chatContent, guardIsBlocked, guardIsSafe, isTerminalStatus };
+export { type A2aResponse, AgentClient, type AgentListResponse, type AgentRunResponse, AgentsClient, type AgentsClientConfig, 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 CreateAgentInput, type DeployedAgent, type DetailLevel, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type GraphNode, type GuardClaim, type GuardMode, type GuardResponse, HttpClient, type HttpClientConfig, HttpError, 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, type StateTransition, type Task, type TaskClaim, type TaskStatus, type TaskVerification, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, type UpdateAgentPatch, ValidationError, type Verdict, WauldoError, chatContent, guardIsBlocked, guardIsSafe, isTerminalStatus, supportScore };

package/dist/index.d.ts

@@ -716,13 +716,24 @@ interface TaskClaim {
  * Verification block attached to completed tasks. When
  * `verification_source === "prompt_only"` the `confidence` and
  * `hallucination_rate` fields reflect self-consistency only; rely on
- * `verdict` + `trust_score` + `message` as authoritative.
+ * `verdict` + `support_score` (alias `trust_score`) + `message` as authoritative.
+ *
+ * Note: `support_score` is the public name for the same numeric value
+ * the wire protocol calls `trust_score`. The JSON wire field is unchanged
+ * for backward compatibility — use `supportScore(v)` to read the value
+ * by its public name. New code should prefer `support_score`.
  */
 interface TaskVerification {
     verdict: Verdict;
     hallucination_rate: number;
     confidence: number;
     trust_score: number;
+    /**
+     * Public name for `trust_score` (0-1 fraction of claims supported
+     * by the sources). Optional on the wire; always equals `trust_score`
+     * when populated. Prefer the `supportScore()` helper to read it.
+     */
+    support_score?: number;
     verification_source: string;
     claims: TaskClaim[];
     verification_retries: number;
@@ -731,6 +742,13 @@ interface TaskVerification {
     sources_cited?: number[];
     stripped_claims?: string[];
 }
+/**
+ * Read the support score of a verification block. Falls back to
+ * `trust_score` when the optional `support_score` field is absent
+ * (the JSON wire format only emits `trust_score` for backward
+ * compatibility). Always returns the same numeric value either way.
+ */
+declare function supportScore(v: TaskVerification): number;
 /** Full task record returned by `GET /v1/tasks/:id`. */
 interface Task {
     task_id: string;
@@ -783,8 +801,8 @@ declare class AgentsClient {
     get(agentId: string): Promise<DeployedAgent>;
     update(agentId: string, patch: UpdateAgentPatch): Promise<DeployedAgent>;
     delete(agentId: string): Promise<void>;
-    run(agentId: string, input: string, verificationMode?: "strict" | "balanced" | "permissive"): Promise<AgentRunResponse>;
-    a2aInvoke(agentId: string, input: string, trace?: string[], verificationMode?: "strict" | "balanced" | "permissive"): Promise<A2aResponse>;
+    run(agentId: string, input: string, verificationMode?: "strict" | "balanced" | "permissive", factCheckMode?: "lexical" | "hybrid" | "semantic"): Promise<AgentRunResponse>;
+    a2aInvoke(agentId: string, input: string, trace?: string[], verificationMode?: "strict" | "balanced" | "permissive", factCheckMode?: "lexical" | "hybrid" | "semantic"): Promise<A2aResponse>;
     /** `GET /v1/tasks/:id` — fetch the current state of a task. */
     getTask(taskId: string): Promise<Task>;
     /** `DELETE /v1/tasks/:id` — cancel a queued or running task. */
@@ -815,4 +833,4 @@ declare class AgentsClient {
     streamTask(taskId: string): AsyncGenerator<StateTransition>;
 }
 
-export { type A2aResponse, AgentClient, type AgentListResponse, type AgentRunResponse, AgentsClient, type AgentsClientConfig, 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 CreateAgentInput, type DeployedAgent, type DetailLevel, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type GraphNode, type GuardClaim, type GuardMode, type GuardResponse, HttpClient, type HttpClientConfig, HttpError, 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, type StateTransition, type Task, type TaskClaim, type TaskStatus, type TaskVerification, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, type UpdateAgentPatch, ValidationError, type Verdict, WauldoError, chatContent, guardIsBlocked, guardIsSafe, isTerminalStatus };
+export { type A2aResponse, AgentClient, type AgentListResponse, type AgentRunResponse, AgentsClient, type AgentsClientConfig, 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 CreateAgentInput, type DeployedAgent, type DetailLevel, type EmbeddingData, type EmbeddingResponse, type EmbeddingUsage, type GraphNode, type GuardClaim, type GuardMode, type GuardResponse, HttpClient, type HttpClientConfig, HttpError, 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, type StateTransition, type Task, type TaskClaim, type TaskStatus, type TaskVerification, TimeoutError, type ToolContent, type ToolDefinition, ToolNotFoundError, type UpdateAgentPatch, ValidationError, type Verdict, WauldoError, chatContent, guardIsBlocked, guardIsSafe, isTerminalStatus, supportScore };

package/dist/index.js

@@ -35,7 +35,8 @@ __export(index_exports, {
   chatContent: () => chatContent,
   guardIsBlocked: () => guardIsBlocked,
   guardIsSafe: () => guardIsSafe,
-  isTerminalStatus: () => isTerminalStatus
+  isTerminalStatus: () => isTerminalStatus,
+  supportScore: () => supportScore
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1290,6 +1291,9 @@ function guardIsBlocked(response) {
 
 // src/agents.ts
 var MAX_RESPONSE_SIZE = 10 * 1024 * 1024;
+function supportScore(v) {
+  return v.support_score ?? v.trust_score;
+}
 function isTerminalStatus(s) {
   return s === "completed" || s === "failed" || s === "cancelled";
 }
@@ -1403,20 +1407,22 @@ var AgentsClient = class {
     await this.request("DELETE", `/v1/agents/${agentId}`);
   }
   // ── Runs ────────────────────────────────────────────────────────
-  async run(agentId, input, verificationMode) {
+  async run(agentId, input, verificationMode, factCheckMode) {
     if (!input) throw new Error("input is required");
     const body = { input };
     if (verificationMode) body.verification_mode = verificationMode;
+    if (factCheckMode) body.fact_check_mode = factCheckMode;
     return await this.request(
       "POST",
       `/v1/agents/${agentId}/runs`,
       body
     );
   }
-  async a2aInvoke(agentId, input, trace, verificationMode) {
+  async a2aInvoke(agentId, input, trace, verificationMode, factCheckMode) {
     if (!input) throw new Error("input is required");
     const body = { input };
     if (verificationMode) body.verification_mode = verificationMode;
+    if (factCheckMode) body.fact_check_mode = factCheckMode;
     const extraHeaders = {};
     if (trace && trace.length > 0) extraHeaders["x-a2a-trace"] = trace.join(",");
     return await this.request(
@@ -1529,5 +1535,6 @@ var AgentsClient = class {
   chatContent,
   guardIsBlocked,
   guardIsSafe,
-  isTerminalStatus
+  isTerminalStatus,
+  supportScore
 });

package/dist/index.mjs

@@ -1249,6 +1249,9 @@ function guardIsBlocked(response) {
 
 // src/agents.ts
 var MAX_RESPONSE_SIZE = 10 * 1024 * 1024;
+function supportScore(v) {
+  return v.support_score ?? v.trust_score;
+}
 function isTerminalStatus(s) {
   return s === "completed" || s === "failed" || s === "cancelled";
 }
@@ -1362,20 +1365,22 @@ var AgentsClient = class {
     await this.request("DELETE", `/v1/agents/${agentId}`);
   }
   // ── Runs ────────────────────────────────────────────────────────
-  async run(agentId, input, verificationMode) {
+  async run(agentId, input, verificationMode, factCheckMode) {
     if (!input) throw new Error("input is required");
     const body = { input };
     if (verificationMode) body.verification_mode = verificationMode;
+    if (factCheckMode) body.fact_check_mode = factCheckMode;
     return await this.request(
       "POST",
       `/v1/agents/${agentId}/runs`,
       body
     );
   }
-  async a2aInvoke(agentId, input, trace, verificationMode) {
+  async a2aInvoke(agentId, input, trace, verificationMode, factCheckMode) {
     if (!input) throw new Error("input is required");
     const body = { input };
     if (verificationMode) body.verification_mode = verificationMode;
+    if (factCheckMode) body.fact_check_mode = factCheckMode;
     const extraHeaders = {};
     if (trace && trace.length > 0) extraHeaders["x-a2a-trace"] = trace.join(",");
     return await this.request(
@@ -1487,5 +1492,6 @@ export {
   chatContent,
   guardIsBlocked,
   guardIsSafe,
-  isTerminalStatus
+  isTerminalStatus,
+  supportScore
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wauldo",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Official TypeScript SDK for Wauldo — Verified AI answers from your documents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,10 +42,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/wauldo/wauldo-sdk-js"
+    "url": "https://github.com/wauldoai/wauldo-sdk-js"
   },
   "bugs": {
-    "url": "https://github.com/wauldo/wauldo-sdk-js/issues"
+    "url": "https://github.com/wauldoai/wauldo-sdk-js/issues"
   },
   "homepage": "https://wauldo.com",
   "engines": {