@indexnetwork/protocol 14.3.2-rc.477.1 → 16.1.1-rc.478.1

package/dist/discovery/hyde.graph.d.ts

@@ -5,7 +5,7 @@ import type { EmbeddingGenerator } from '../shared/interfaces/embedder.interface
 import { type HydeGenerationMode } from './hyde.env.js';
 import { type HydeSourceFrame } from './hyde.frame.js';
 import type { HydeGenerateInput, HydeGeneratorOutput } from './hyde.generator.js';
-import { type HydeDocumentState } from './hyde.state.js';
+import { HydeGraphState, type HydeDocumentState } from './hyde.state.js';
 import type { LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';
 import { type HydeValidationInput, type HydeValidationOutput } from './hyde.validator.js';
 /** Narrow lens inferrer contract accepted by the graph. */
@@ -25,18 +25,29 @@ export interface HydeGraphOptions {
     mode?: HydeGenerationMode;
     validator?: HydeValidatorLike;
 }
+/** The graph's channel state, as every node sees it. */
+export type HydeState = typeof HydeGraphState.State;
+/** Everything the HyDE nodes reach for. */
+export interface HydeGraphDeps {
+    database: HydeGraphDatabase;
+    embedder: EmbeddingGenerator;
+    cache: HydeCache;
+    inferrer: HydeLensInferrerLike;
+    generator: HydeGeneratorLike;
+    options: HydeGraphOptions;
+    /** Resolved generation mode; decides whether the validate stage runs. */
+    mode: HydeGenerationMode;
+    /** Present only in frame-generation mode. */
+    validator?: HydeValidatorLike;
+}
 /** Factory for the HyDE generation graph. Existing five-argument calls remain valid. */
 export declare class HydeGraphFactory {
-    private database;
-    private embedder;
-    private cache;
-    private inferrer;
-    private generator;
-    private options;
+    /** Resolved dependency bag shared by every node. */
+    readonly deps: HydeGraphDeps;
     constructor(database: HydeGraphDatabase, embedder: EmbeddingGenerator, cache: HydeCache, inferrer: HydeLensInferrerLike, generator: HydeGeneratorLike, options?: HydeGraphOptions);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         sourceType: "intent" | "context" | "query";
-        sourceId: import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined;
+        sourceId: import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined;
         sourceText: string;
         profileContext: string | undefined;
         maxLenses: number;
@@ -52,7 +63,7 @@ export declare class HydeGraphFactory {
         agentTimings: DebugMetaAgent[];
     }, {
         sourceType?: "intent" | "context" | "query" | undefined;
-        sourceId?: import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined;
+        sourceId?: import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined> | undefined;
         sourceText?: string | undefined;
         profileContext?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         maxLenses?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
@@ -66,13 +77,13 @@ export declare class HydeGraphFactory {
         hydeEmbeddings?: Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         agentTimings?: DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]> | undefined;
-    }, "__start__" | "infer_lenses" | "check_cache" | "generate_missing" | "embed" | "cache_results", {
+    }, "__start__" | "embed" | "infer_lenses" | "check_cache" | "generate_missing" | "cache_results", {
         sourceType: {
             (annotation: import("@langchain/langgraph").SingleReducer<"intent" | "context" | "query", "intent" | "context" | "query">): import("@langchain/langgraph").BaseChannel<"intent" | "context" | "query", "intent" | "context" | "query" | import("@langchain/langgraph").OverwriteValue<"intent" | "context" | "query">, unknown>;
             (): import("@langchain/langgraph").LastValue<"intent" | "context" | "query">;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined, import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
+        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined, import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined> | undefined, unknown>;
         sourceText: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;
@@ -96,7 +107,7 @@ export declare class HydeGraphFactory {
             (): import("@langchain/langgraph").LastValue<"intent" | "context" | "query">;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined, import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
+        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined, import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined> | undefined, unknown>;
         sourceText: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;
@@ -148,3 +159,51 @@ export declare class HydeGraphFactory {
         cache_results: {};
     }, unknown, unknown, []>;
 }
+/** Node 1: Infer lenses from source text + optional profile context. */
+export declare function inferLensesNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    lenses: import("./lens.inferrer.js").Lens[];
+    sourceFrame: HydeSourceFrame;
+    frameFingerprint: string;
+    sourceTextHash: string;
+    generatedAt: string;
+    agentTimings: DebugMetaAgent[];
+} | {
+    lenses: import("./lens.inferrer.js").Lens[];
+    agentTimings: DebugMetaAgent[];
+    sourceFrame?: undefined;
+    frameFingerprint?: undefined;
+    sourceTextHash?: undefined;
+    generatedAt?: undefined;
+}>;
+/** Node 2: Check the mode-isolated cache/DB for matching documents. */
+export declare function checkCacheNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: {
+        [k: string]: HydeDocumentState;
+    };
+}>;
+/** Node 3: Generate all missing documents and return a complete snapshot. */
+export declare function generateMissingNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: {
+        [x: string]: HydeDocumentState;
+    };
+    agentTimings: DebugMetaAgent[];
+}>;
+/** Frame-v1 only: validate newly generated docs in one batch. */
+export declare function validateGeneratedNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: Record<string, HydeDocumentState>;
+    agentTimings?: undefined;
+} | {
+    hydeDocuments: {
+        [x: string]: HydeDocumentState;
+    };
+    agentTimings: DebugMetaAgent[];
+}>;
+/** Embed all accepted/cached documents that do not have embeddings. */
+export declare function embedNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: Record<string, HydeDocumentState>;
+    hydeEmbeddings: Record<string, number[]>;
+}>;
+/** Cache/persist only legacy docs or successfully validated frame-v1 docs. */
+export declare function cacheResultsNode(state: HydeState, deps: HydeGraphDeps): Promise<{}>;
+/** After the cache check: generate the missing documents, or skip straight to embedding. */
+export declare function shouldGenerate(state: HydeState): string;