@absolutejs/rag 0.11.0 → 0.13.0

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

@@ -0,0 +1,24 @@
+export type WebLink = {
+    url: string;
+    label: string;
+};
+export type WebImage = {
+    url: string | null;
+    label: string;
+    context: string;
+};
+export type WebMedia = {
+    kind: "video" | "audio" | "embed" | "captions";
+    url: string;
+    label: string;
+};
+export type WebEvidence = {
+    links: WebLink[];
+    images: WebImage[];
+    media: WebMedia[];
+    canonicalUrl: string | null;
+};
+/** Preserve semantic evidence that visible body text omits. Labels are not verified customer relationships. */
+export declare const extractWebEvidence: (html: string, url: string) => WebEvidence;
+/** Navigation/footer text alone must not mask an empty or loading app root. */
+export declare const hasIncompleteAppContent: (html: string) => boolean;

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

@@ -1,3 +1,7 @@
+import { type WebEvidence } from "./evidence";
+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 type { WebFetchResult, WebFetchOptions } from "./transport";
@@ -21,6 +25,9 @@ export type WebReadResult = {
         message: string;
     };
     fetchedAt: string;
+    redirects: WebRedirect[];
+    evidence: WebEvidence;
+    limitations: string[];
 };
 export type WebRenderer = (url: string, options: {
     signal: AbortSignal;
@@ -29,6 +36,8 @@ export type WebRenderer = (url: string, options: {
     text?: string;
     url: string;
     status: number;
+    redirects?: WebRedirect[];
+    settled?: boolean;
 }>;
 export type ReadWebpageOptions = {
     url: string;
@@ -40,3 +49,4 @@ export type ReadWebpageOptions = {
 };
 /** Read prepared evidence, escalating thin HTML shells to a host-supplied browser. */
 export declare const readRAGWebpage: (options: ReadWebpageOptions) => Promise<WebReadResult>;
+export { readRAGWebsite } from "./website";

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

@@ -3,7 +3,14 @@ export declare class WebReadError extends Error {
     constructor(code: string, message: string);
 }
 export declare const isPublicWebAddress: (address: string) => boolean;
+export type WebRedirect = {
+    from: string;
+    to: string;
+    kind: "http" | "client";
+    status?: number;
+};
 export type WebFetchResult = {
+    redirects?: WebRedirect[];
     url: string;
     status: number;
     headers: Record<string, string>;

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

@@ -0,0 +1,62 @@
+import { type ReadWebpageOptions, type WebReadResult } from "./index";
+/** Bounded company research: preserve citations and follow relevant same-origin links. */
+export declare const readRAGWebsite: (options: ReadWebpageOptions & {
+    maxPages?: number;
+}) => Promise<{
+    status: WebReadResult["status"];
+    text: string;
+    truncated: boolean;
+    pages: {
+        status: "ok" | "partial" | "error";
+        url: string;
+        finalUrl: string;
+        title: string | null;
+        method: "http" | "browser";
+        truncated: boolean;
+        attempts: import("./index").WebReadAttempt[];
+        error?: {
+            code: string;
+            message: string;
+        };
+        fetchedAt: string;
+        redirects: import("./transport").WebRedirect[];
+        evidence: import("./evidence").WebEvidence;
+        limitations: string[];
+    }[];
+    captionEvidence: {
+        url: string;
+        text: string;
+        error?: string;
+    }[];
+    coverage: {
+        pagesRead: number;
+        pageLimit: number;
+        remainingRelevantLinks: string[];
+        deadlineReached: boolean;
+        exhaustive: boolean;
+        stopReason: string;
+        incompleteReads: {
+            url: string;
+            status: "error" | "partial" | "ok";
+            truncated: boolean;
+            error: {
+                code: string;
+                message: string;
+            } | undefined;
+        }[];
+    };
+    citationGuidance: string;
+    url: string;
+    finalUrl: string;
+    title: string | null;
+    method: "http" | "browser";
+    attempts: import("./index").WebReadAttempt[];
+    error?: {
+        code: string;
+        message: string;
+    };
+    fetchedAt: string;
+    redirects: import("./transport").WebRedirect[];
+    evidence: import("./evidence").WebEvidence;
+    limitations: string[];
+}>;