@absolutejs/rag 0.18.0 → 0.19.0

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

@@ -5,10 +5,15 @@ export declare const ReviewSchema: import("@sinclair/typebox").TObject<{
         path: import("@sinclair/typebox").TString;
         verdict: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"unknown" | "supported" | "unsupported" | "conflicting">[]>;
         citations: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            sourceId: import("@sinclair/typebox").TString;
-            quote: import("@sinclair/typebox").TString;
+            passageId: import("@sinclair/typebox").TString;
         }>>;
         reason: import("@sinclair/typebox").TString;
+        checks: import("@sinclair/typebox").TObject<{
+            answersQuestion: import("@sinclair/typebox").TBoolean;
+            correctEntity: import("@sinclair/typebox").TBoolean;
+            correctTime: import("@sinclair/typebox").TBoolean;
+            preservesScope: import("@sinclair/typebox").TBoolean;
+        }>;
     }>>;
 }>;
 export declare const researchLeaves: (value: unknown, maxFields?: number) => Pick<ResearchField, "value" | "path">[];
@@ -18,4 +23,25 @@ export declare const bindResearchReview: (leaves: ReturnType<typeof researchLeav
     verdict: ResearchField["verdict"];
     citations: ResearchField["citations"];
     reason: string;
+    checks?: ResearchField["checks"];
 }[], sources: SearchSource[]) => ResearchField[];
+/** Stable references let the runtime copy evidence instead of asking a model to transcribe it. */
+export declare const researchPassages: (sources: SearchSource[]) => {
+    passages: {
+        id: string;
+        text: string;
+    }[];
+    id: string;
+    url: string;
+    title: string;
+    retrievedAt: string;
+    publishedAt?: string;
+    contentFetchedAt?: string;
+    metadata?: Record<string, unknown>;
+}[];
+export declare const resolveResearchPassages: (citations: {
+    passageId: string;
+}[], sources: ReturnType<typeof researchPassages>) => {
+    sourceId: string;
+    quote: string;
+}[];

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

@@ -0,0 +1,8 @@
+import { type TSchema, type Static as LegacyStatic } from "@sinclair/typebox";
+import type { Static } from "typebox";
+/** JSON-compatible TypeBox 0.34 or TypeBox 1 schemas, including Elysia 2's t. */
+export type ResearchSchema = TSchema | {
+    "~kind": string;
+};
+export type ResearchStatic<S extends ResearchSchema> = S extends TSchema ? LegacyStatic<S> : Static<S>;
+export declare const checkResearchValue: <S extends ResearchSchema>(schema: S, value: unknown) => value is ResearchStatic<S>;

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

@@ -1,6 +1,7 @@
 import type { AIProviderConfig, AIUsage } from "@absolutejs/ai";
 import type { SearchProvider, SearchResult, SearchSource, SearchCacheStore } from "@absolutejs/search";
-import type { TSchema, Static } from "@sinclair/typebox";
+import type { ResearchSchema, ResearchStatic } from "./schema";
+export type { ResearchSchema, ResearchStatic } from "./schema";
 import type { ReadWebpageOptions, WebReadResult } from "../web";
 export type ResearchOperation = "search" | "read" | "plan" | "extract" | "review";
 export type ResearchProgress = {
@@ -18,6 +19,13 @@ export type ResearchField = {
         quote: string;
     }[];
     reason: string;
+    /** Model judgments, not independent verification; all must pass for support. */
+    checks?: {
+        answersQuestion: boolean;
+        correctEntity: boolean;
+        correctTime: boolean;
+        preservesScope: boolean;
+    };
 };
 export type ResearchResult<T = unknown> = {
     id: string;
@@ -36,7 +44,7 @@ export type ResearchResult<T = unknown> = {
         durationMs: number;
     }[];
 };
-export type ResearchTask<S extends TSchema = TSchema> = {
+export type ResearchTask<S extends ResearchSchema = ResearchSchema> = {
     schema: S;
     instructions?: string;
 };
@@ -65,6 +73,11 @@ export type ResearchConfig = {
     search: SearchProvider;
     provider: AIProviderConfig;
     model: string;
+    /** Optional separate reviewer. Host reservations must price this model too. */
+    reviewer?: {
+        provider: AIProviderConfig;
+        model: string;
+    };
     tasks?: Record<string, ResearchTask>;
     limits?: Partial<ResearchLimits>;
     /** Explicit shared-public or tenant scope. Omit to disable search caching. */
@@ -91,5 +104,5 @@ export type ResearchConfig = {
 };
 export type ResearchRuntime = {
     run: (input: ResearchInput) => Promise<ResearchResult>;
-    extract: <S extends TSchema>(task: ResearchTask<S>, input: ResearchInput) => Promise<ResearchResult<Static<S>>>;
+    extract: <S extends ResearchSchema>(task: ResearchTask<S>, input: ResearchInput) => Promise<ResearchResult<ResearchStatic<S>>>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/rag",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "homepage": "https://github.com/absolutejs/rag",
   "bugs": {
     "url": "https://github.com/absolutejs/rag/issues"
@@ -84,13 +84,14 @@
     "manifestContract": 2
   },
   "dependencies": {
+    "@absolutejs/egress": "^0.3.1",
     "@absolutejs/manifest": "^0.9.0",
+    "@absolutejs/search": "^0.2.0",
     "@sinclair/typebox": "^0.34.0",
     "linkedom": "0.18.13",
-    "pdfjs-dist": "6.3.289",
     "pdf-lib": "1.17.1",
-    "@absolutejs/egress": "^0.3.0",
-    "@absolutejs/search": "^0.2.0"
+    "pdfjs-dist": "6.3.289",
+    "typebox": "^1.3.16"
   },
   "peerDependencies": {
     "@angular/core": "^21.0.0",
@@ -153,7 +154,8 @@
     "test": "bun test",
     "release": "bun run build && bun publish --access public",
     "check:package": "absolute-changelog check",
-    "prepublishOnly": "bun run check:package"
+    "prepublishOnly": "bun run check:package",
+    "test:research-types": "tsc --project tsconfig.research-types.json"
   },
   "publishConfig": {
     "access": "public"