@absolutejs/rag 0.22.12 → 0.22.14

package/dist/src/research/types.d.ts

@@ -35,6 +35,16 @@ export type ResearchResult<T = unknown> = {
         text: string;
         originalChars: number;
     }>;
+    sourceFailures?: Array<{
+        url: string;
+        code: string;
+        message: string;
+    }>;
+    coverage?: {
+        requested: number;
+        supported: number;
+        complete: boolean;
+    };
     id: string;
     status: "reviewed" | "partial" | "empty" | "unavailable";
     /** Only populated when every primitive field passed evidence review. */
@@ -53,6 +63,12 @@ export type ResearchResult<T = unknown> = {
 };
 export type ResearchTask<S extends ResearchSchema = ResearchSchema> = {
     schema: S;
+    /** Count only items whose required fields passed evidence review. JSON pointer to an array. */
+    collection?: {
+        path: string;
+        minimum: number;
+        requiredFields: string[];
+    };
     instructions?: string;
 };
 export type ResearchInput = {

package/dist/src/web/index.d.ts

@@ -3,7 +3,7 @@ import type { WebRedirect } from "./transport";
 export type { WebEvidence, WebLink, WebImage, WebMedia } from "./evidence";
 export type { WebRedirect } from "./transport";
 import { fetchPublicWebResource } from "./transport";
-export { fetchPublicWebResource, validatePublicWebUrl, isPublicWebAddress, WebReadError, } from "./transport";
+export { fetchPublicWebResource, validatePublicWebUrl, isPublicWebAddress, WebReadError, isWebReadError, } from "./transport";
 export type { WebFetchResult, WebFetchOptions } from "./transport";
 export type WebReadAttempt = {
     method: "http" | "browser";

package/dist/src/web/transport.d.ts

@@ -1,7 +1,10 @@
+declare const WEB_READ_ERROR: unique symbol;
 export declare class WebReadError extends Error {
     code: string;
+    readonly [WEB_READ_ERROR] = true;
     constructor(code: string, message: string);
 }
+export declare const isWebReadError: (error: unknown) => error is WebReadError;
 export declare const isPublicWebAddress: (address: string) => boolean;
 export type WebRedirect = {
     from: string;
@@ -27,3 +30,4 @@ export type WebFetchOptions = {
 export declare const validatePublicWebUrl: (raw: string) => URL;
 /** Pin the validated DNS answer into the connection, including every redirect. */
 export declare const fetchPublicWebResource: (raw: string, options?: WebFetchOptions) => Promise<WebFetchResult>;
+export {};

package/dist/web/index.js

@@ -111008,15 +111008,18 @@ import {
 import { lookup } from "dns/promises";
 import { isIP } from "net";
 import { brotliDecompressSync, gunzipSync, inflateSync } from "zlib";
+var WEB_READ_ERROR = Symbol.for("@absolutejs/rag/WebReadError");
 
 class WebReadError extends Error {
   code;
+  [WEB_READ_ERROR] = true;
   constructor(code, message) {
     super(message);
     this.code = code;
     this.name = "WebReadError";
   }
 }
+var isWebReadError = (error) => error instanceof Error && Reflect.get(error, WEB_READ_ERROR) === true && typeof Reflect.get(error, "code") === "string";
 var isPublicWebAddress = (address) => isPublicNetworkAddress(address);
 var validatePublicWebUrl = (raw) => {
   let url;
@@ -117886,7 +117889,7 @@ var createWebpageReaderClient = (options) => {
     });
     if (result.status === "error") {
       const error = result.error;
-      throw new Error(error?.message ?? "Isolated page read failed");
+      throw new WebReadError(error?.code ?? "reader_unavailable", error?.message ?? "Isolated page read failed");
     }
     const documents = result.documents;
     const sources = result.sources;
@@ -117920,7 +117923,7 @@ var createWebpageReaderClient = (options) => {
 
 // src/web/index.ts
 var messageFor = (error) => error instanceof Error ? error.message : "Website retrieval failed.";
-var codeFor = (error) => error instanceof WebReadError ? error.code : error instanceof Error && /^(?:AbortError|TimeoutError)$/u.test(error.name) ? "timeout" : "fetch_failed";
+var codeFor = (error) => isWebReadError(error) ? error.code : error instanceof Error && /^(?:AbortError|TimeoutError)$/u.test(error.name) ? "timeout" : "fetch_failed";
 var cleanHtml = websiteHtmlText;
 var titleOf = (html) => {
   const title = /<title\b[^>]*>([\s\S]*?)<\/title>/iu.exec(html)?.[1];
@@ -117967,7 +117970,7 @@ var readRAGWebpage = async (options) => {
       response = await (options.fetchResource ?? fetchPublicWebResource)(options.url, { signal, maxBytes: 5000000 });
     } catch (error) {
       attempts.push({ method: "http", status: codeFor(error) });
-      if (error instanceof WebReadError && error.code === "blocked_url")
+      if (isWebReadError(error) && error.code === "blocked_url")
         throw error;
       if (!options.render)
         throw error;
@@ -118089,11 +118092,12 @@ export {
   createWebsiteReaderClient,
   fetchPublicWebResource,
   isPublicWebAddress,
+  isWebReadError,
   parseWebsiteServiceResult,
   readRAGWebpage,
   readRAGWebsite,
   validatePublicWebUrl
 };
 
-//# debugId=ED6DDC20D653823F64756E2164756E21
+//# debugId=1563C3DC46ACBE2864756E2164756E21
 //# sourceMappingURL=index.js.map