@agenttool/sdk 0.2.7 → 0.2.9

package/README.md

@@ -110,6 +110,13 @@ const r = await at.verify.check("Bitcoin was created in 2009.", {
   domain: "finance",             // "finance" | "science" | "medical" | "legal" | "general"
   context: "On the whitepaper publication date",
 });
+
+// Batch verify up to 10 claims in parallel
+const results = await at.verify.batch([
+  { claim: "The Earth orbits the Sun." },
+  { claim: "Water boils at 100°C at sea level.", domain: "science" },
+]);
+// returns VerifyResult[] in same order
 ```
 
 ### Economy (wallets & escrows)

package/dist/types.d.ts

@@ -78,13 +78,42 @@ export interface ExecuteResult {
     exit_code: number;
     duration_ms: number;
 }
+/** A single source returned by agent-verify. */
+export interface VerifySource {
+    url: string;
+    title: string;
+    date?: string;
+    reliability: number;
+}
+/** Evidence grouped by position. */
+export interface VerifyEvidence {
+    supporting: Array<{
+        url: string;
+        title: string;
+        snippet: string;
+        reliability: number;
+    }>;
+    contradicting: Array<{
+        url: string;
+        title: string;
+        snippet: string;
+        reliability: number;
+    }>;
+    neutral: Array<{
+        url: string;
+        title: string;
+        snippet: string;
+        reliability: number;
+    }>;
+}
 /** Result of a verification request. */
 export interface VerifyResult {
-    verdict: string;
+    verdict: "verified" | "false" | "disputed" | "unverifiable";
     confidence: number;
-    sources: string[];
-    evidence: string;
+    sources: VerifySource[];
+    evidence: VerifyEvidence;
     caveats: string[];
+    processingMs?: number;
 }
 /** A wallet object. */
 export interface Wallet {

package/dist/verify.d.ts

@@ -18,13 +18,40 @@ export declare class VerifyClient {
     /** @internal */
     constructor(http: HttpConfig);
     /**
-     * Verify a claim.
+     * Verify a claim with AI-powered evidence gathering.
      *
-     * @param claim - The statement to verify.
-     * @param options - Optional sources array.
-     * @returns VerifyResult with verdict, confidence, sources, evidence, caveats.
+     * @param claim - The statement to verify (max 2000 chars).
+     * @param options - Optional context and domain hint.
+     * @returns VerifyResult with verdict, confidence, evidence, caveats.
+     *
+     * @example
+     * ```ts
+     * const r = await at.verify.check("The Eiffel Tower is 330m tall.", { domain: "general" });
+     * console.log(r.verdict, r.confidence); // "disputed" 0.71
+     * ```
      */
     check(claim: string, options?: {
-        sources?: string[];
+        context?: string;
+        domain?: "finance" | "legal" | "medical" | "science" | "general";
     }): Promise<VerifyResult>;
+    /**
+     * Batch-verify up to 10 claims in parallel.
+     *
+     * @param claims - Array of claim objects (max 10). Each must include `claim`;
+     *   `context` and `domain` are optional per-claim.
+     * @returns Array of VerifyResult in the same order as input.
+     *
+     * @example
+     * ```ts
+     * const results = await at.verify.batch([
+     *   { claim: "The Earth orbits the Sun." },
+     *   { claim: "Water boils at 100°C at sea level.", domain: "science" },
+     * ]);
+     * ```
+     */
+    batch(claims: Array<{
+        claim: string;
+        context?: string;
+        domain?: "finance" | "legal" | "medical" | "science" | "general";
+    }>): Promise<VerifyResult[]>;
 }

package/dist/verify.js

@@ -19,16 +19,24 @@ export class VerifyClient {
         this.http = http;
     }
     /**
-     * Verify a claim.
+     * Verify a claim with AI-powered evidence gathering.
      *
-     * @param claim - The statement to verify.
-     * @param options - Optional sources array.
-     * @returns VerifyResult with verdict, confidence, sources, evidence, caveats.
+     * @param claim - The statement to verify (max 2000 chars).
+     * @param options - Optional context and domain hint.
+     * @returns VerifyResult with verdict, confidence, evidence, caveats.
+     *
+     * @example
+     * ```ts
+     * const r = await at.verify.check("The Eiffel Tower is 330m tall.", { domain: "general" });
+     * console.log(r.verdict, r.confidence); // "disputed" 0.71
+     * ```
      */
     async check(claim, options) {
         const body = { claim };
-        if (options?.sources !== undefined)
-            body.sources = options.sources;
+        if (options?.context !== undefined)
+            body.context = options.context;
+        if (options?.domain !== undefined)
+            body.domain = options.domain;
         const url = `${this.http.baseUrl}/v1/verify`;
         const resp = await globalThis.fetch(url, {
             method: "POST",
@@ -51,4 +59,42 @@ export class VerifyClient {
         }
         return (await resp.json());
     }
+    /**
+     * Batch-verify up to 10 claims in parallel.
+     *
+     * @param claims - Array of claim objects (max 10). Each must include `claim`;
+     *   `context` and `domain` are optional per-claim.
+     * @returns Array of VerifyResult in the same order as input.
+     *
+     * @example
+     * ```ts
+     * const results = await at.verify.batch([
+     *   { claim: "The Earth orbits the Sun." },
+     *   { claim: "Water boils at 100°C at sea level.", domain: "science" },
+     * ]);
+     * ```
+     */
+    async batch(claims) {
+        const url = `${this.http.baseUrl}/v1/verify/batch`;
+        const resp = await globalThis.fetch(url, {
+            method: "POST",
+            headers: this.http.headers,
+            body: JSON.stringify({ claims }),
+            signal: AbortSignal.timeout(this.http.timeout),
+        });
+        if (resp.status >= 400) {
+            let detail;
+            try {
+                const json = (await resp.json());
+                detail = json.detail ?? resp.statusText;
+            }
+            catch {
+                detail = resp.statusText;
+            }
+            throw new AgentToolError(`Verify API error (${resp.status}): ${detail}`, {
+                hint: "Check your API key and request parameters.",
+            });
+        }
+        return (await resp.json());
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenttool/sdk",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "TypeScript SDK for agenttool.dev — memory and tools for AI agents",
   "type": "module",
   "main": "dist/index.js",