@absolutejs/rag 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.13.0 — 2026-09-18
+
+### Added
+
+- **Expose stop reasons and actual incomplete page reads separately from unvisited links; guide targeted continuation and concise nontechnical answers.** (`readRAGWebsite`)
+
+### Changed
+
+- **Balance repeated customer, service and company reads across an eight-page default budget (maximum twelve) with 48000 characters, preventing case-study archives from starving service details.** (`readRAGWebsite`)
+
+## 0.12.0 — 2026-09-18
+
+### Added
+
+- **Add bounded multi-page website research with exact page citations, semantic links and image labels, media and caption evidence, redirect chains and explicit coverage limits.**
+
+### Changed
+
+- **Expand website result and renderer contracts with semantic evidence, redirect hops and explicit readiness/coverage metadata; existing renderers may omit the new optional renderer fields.** (`WebFetchResult`, `WebReadResult`, `WebRenderer`, `readRAGWebpage`, `createPlaywrightWebRenderer`)
+
 ## 0.11.0 — 2026-09-18
 
 ### Added

package/README.md

@@ -162,3 +162,25 @@ bounded. The reader does not bypass login, CAPTCHA or access restrictions, and
 reports these failures separately from incomplete rendering. A page read is not
 a crawl of every page on a domain. Host-supplied renderers/fetch implementations
 must enforce equivalent network controls.
+
+### Research related website pages with attributable evidence
+
+`readRAGWebsite` from `@absolutejs/rag/web` reads up to eight pages by default, balancing
+same-origin customer, service and company pages so service details are not
+starved by large case-study archives. The configurable ceiling is twelve pages;
+the overall deadline remains 75 seconds and default text budget is 48,000 characters. Pass the
+optional Playwright renderer as for `readRAGWebpage`. `maxPages: 1` retains a
+single-page read; `mode: "browser"` retries content missed by static extraction.
+Results attribute text to exact page URLs and retain per-page redirects,
+retrieval attempts, semantic image labels, link destinations, media URLs and
+available caption text. Coverage includes unvisited relevant links and deadline
+limits. `incompleteReads` identifies failed, partial or truncated page reads;
+unvisited links and successful browser fallback are not failed reads.
+`stopReason` distinguishes a page limit, deadline and exhausted relevant links.
+A per-call limit is not a reason to stop research when a material question remains:
+use targeted follow-up reads. Present business answers first and keep technical
+diagnostics for explicit debugging requests. HTTP redirects carry their actual status; client navigation is labeled
+separately. Empty image labels are not proof of an absent client list, and media
+URLs are not proof that a video was watched. Consumers must cite source URLs,
+distinguish extracted evidence from inference, and finish the requested research
+without treating a successful page fetch as complete company coverage.

package/changelog.json

@@ -2,6 +2,47 @@
 	"contract": 1,
 	"name": "@absolutejs/rag",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "changed",
+					"summary": "Balance repeated customer, service and company reads across an eight-page default budget (maximum twelve) with 48000 characters, preventing case-study archives from starving service details.",
+					"symbols": [
+						"readRAGWebsite"
+					]
+				},
+				{
+					"kind": "added",
+					"summary": "Expose stop reasons and actual incomplete page reads separately from unvisited links; guide targeted continuation and concise nontechnical answers.",
+					"symbols": [
+						"readRAGWebsite"
+					]
+				}
+			],
+			"date": "2026-09-18",
+			"version": "0.13.0"
+		},
+		{
+			"changes": [
+				{
+					"kind": "added",
+					"summary": "Add bounded multi-page website research with exact page citations, semantic links and image labels, media and caption evidence, redirect chains and explicit coverage limits."
+				},
+				{
+					"kind": "changed",
+					"summary": "Expand website result and renderer contracts with semantic evidence, redirect hops and explicit readiness/coverage metadata; existing renderers may omit the new optional renderer fields.",
+					"symbols": [
+						"WebFetchResult",
+						"WebReadResult",
+						"WebRenderer",
+						"readRAGWebpage",
+						"createPlaywrightWebRenderer"
+					]
+				}
+			],
+			"date": "2026-09-18",
+			"version": "0.12.0"
+		},
 		{
 			"changes": [
 				{

package/dist/adapter-kit/index.js

@@ -1,5 +1,37 @@
 // @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  if (mod && typeof mod === "object" || typeof mod === "function") {
+    for (let key of __getOwnPropNames(mod))
+      if (!__hasOwnProp.call(to, key))
+        __defProp(to, key, {
+          get: __accessProp.bind(mod, key),
+          enumerable: true
+        });
+  }
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
   this[name] = __returnValue.bind(null, newValue);
@@ -13,6 +45,7 @@ var __export = (target, all) => {
       set: __exportSetter.bind(all, name)
     });
 };
+var __require = import.meta.require;
 
 // src/quality/quality.ts
 import { mkdir, readFile } from "fs/promises";
@@ -31417,5 +31450,5 @@ export {
   summarizeSQLiteCandidateCoverage
 };
 
-//# debugId=9FE93518A40B2B4664756E2164756E21
+//# debugId=77D38FB1F044066A64756E2164756E21
 //# sourceMappingURL=index.js.map