@indexnetwork/protocol 22.0.0-rc.498.1 → 64.0.0-rc.604.2

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

@@ -1,150 +0,0 @@
-import { z } from 'zod';
-/** Source-grounded role supported by an exact span from the source text. */
-export interface HydeFrameRole {
-    role: string;
-    evidence: string;
-}
-export declare const HYDE_HARD_CONSTRAINT_TYPES: readonly ["location", "time", "numeric", "credential", "organization", "exclusivity", "other"];
-export type HydeHardConstraintType = (typeof HYDE_HARD_CONSTRAINT_TYPES)[number];
-/** Explicit hard constraint supported by an exact span from the source text. */
-export interface HydeFrameHardConstraint {
-    type: HydeHardConstraintType;
-    value: string;
-    evidence: string;
-}
-export declare const HYDE_NAMED_ENTITY_TYPES: readonly ["person", "organization", "product", "location", "event", "other"];
-export type HydeNamedEntityType = (typeof HYDE_NAMED_ENTITY_TYPES)[number];
-/** Named entity supported by an exact span from the source text. */
-export interface HydeFrameNamedEntity {
-    type: HydeNamedEntityType;
-    name: string;
-    evidence: string;
-}
-/** Domain term supported by an exact span from the source text. */
-export interface HydeFrameVocabulary {
-    term: string;
-    evidence: string;
-}
-/**
- * Source-grounded controls for frame-constrained HyDE generation.
- * Counterpart roles may be reciprocal/complementary inferences, but their
- * evidence must still be an exact span from the source text.
- */
-export interface HydeSourceFrame {
-    sourceRoles: HydeFrameRole[];
-    counterpartRoles: HydeFrameRole[];
-    hardConstraints: HydeFrameHardConstraint[];
-    namedEntities: HydeFrameNamedEntity[];
-    domainVocabulary: HydeFrameVocabulary[];
-}
-/** Structured-output schema for source-grounded frames. */
-export declare const HydeSourceFrameSchema: z.ZodObject<{
-    sourceRoles: z.ZodArray<z.ZodObject<{
-        role: z.ZodString;
-        evidence: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        role: string;
-        evidence: string;
-    }, {
-        role: string;
-        evidence: string;
-    }>, "many">;
-    counterpartRoles: z.ZodArray<z.ZodObject<{
-        role: z.ZodString;
-        evidence: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        role: string;
-        evidence: string;
-    }, {
-        role: string;
-        evidence: string;
-    }>, "many">;
-    hardConstraints: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["location", "time", "numeric", "credential", "organization", "exclusivity", "other"]>;
-        value: z.ZodString;
-        evidence: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        value: string;
-        type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
-        evidence: string;
-    }, {
-        value: string;
-        type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
-        evidence: string;
-    }>, "many">;
-    namedEntities: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["person", "organization", "product", "location", "event", "other"]>;
-        name: z.ZodString;
-        evidence: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
-        evidence: string;
-    }, {
-        name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
-        evidence: string;
-    }>, "many">;
-    domainVocabulary: z.ZodArray<z.ZodObject<{
-        term: z.ZodString;
-        evidence: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        evidence: string;
-        term: string;
-    }, {
-        evidence: string;
-        term: string;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    sourceRoles: {
-        role: string;
-        evidence: string;
-    }[];
-    counterpartRoles: {
-        role: string;
-        evidence: string;
-    }[];
-    hardConstraints: {
-        value: string;
-        type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
-        evidence: string;
-    }[];
-    namedEntities: {
-        name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
-        evidence: string;
-    }[];
-    domainVocabulary: {
-        evidence: string;
-        term: string;
-    }[];
-}, {
-    sourceRoles: {
-        role: string;
-        evidence: string;
-    }[];
-    counterpartRoles: {
-        role: string;
-        evidence: string;
-    }[];
-    hardConstraints: {
-        value: string;
-        type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
-        evidence: string;
-    }[];
-    namedEntities: {
-        name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
-        evidence: string;
-    }[];
-    domainVocabulary: {
-        evidence: string;
-        term: string;
-    }[];
-}>;
-/**
- * Remove frame elements that cross the source-evidence boundary. Structured
- * payloads must occur inside their evidence span. Source roles require grounded
- * substantive tokens; counterpart roles may add generic inferred role language.
- */
-export declare function sanitizeHydeSourceFrame(sourceText: string, frame: HydeSourceFrame): HydeSourceFrame;

package/dist/discovery/hyde.frame.js

@@ -1,107 +0,0 @@
-import { z } from 'zod';
-export const HYDE_HARD_CONSTRAINT_TYPES = [
-    'location',
-    'time',
-    'numeric',
-    'credential',
-    'organization',
-    'exclusivity',
-    'other',
-];
-export const HYDE_NAMED_ENTITY_TYPES = [
-    'person',
-    'organization',
-    'product',
-    'location',
-    'event',
-    'other',
-];
-const roleSchema = z.object({
-    role: z.string().min(1),
-    evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),
-});
-const hardConstraintSchema = z.object({
-    type: z.enum(HYDE_HARD_CONSTRAINT_TYPES),
-    value: z.string().min(1),
-    evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),
-});
-const namedEntitySchema = z.object({
-    type: z.enum(HYDE_NAMED_ENTITY_TYPES),
-    name: z.string().min(1),
-    evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),
-});
-const vocabularySchema = z.object({
-    term: z.string().min(1),
-    evidence: z.string().min(1).describe('Exact evidence span copied from sourceText'),
-});
-/** Structured-output schema for source-grounded frames. */
-export const HydeSourceFrameSchema = z.object({
-    sourceRoles: z.array(roleSchema),
-    counterpartRoles: z.array(roleSchema),
-    hardConstraints: z.array(hardConstraintSchema),
-    namedEntities: z.array(namedEntitySchema),
-    domainVocabulary: z.array(vocabularySchema),
-});
-function escapeRegularExpression(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-/** Case-insensitive literal matching bounded by Unicode letters and numbers. */
-function containsAlphanumericSpanCaseInsensitive(container, value) {
-    const needle = value.trim();
-    if (!needle)
-        return false;
-    return new RegExp(`(?<![\\p{L}\\p{M}\\p{N}])${escapeRegularExpression(needle)}(?![\\p{L}\\p{M}\\p{N}])`, 'iu').test(container);
-}
-function hasExactEvidence(sourceText, evidence) {
-    return containsAlphanumericSpanCaseInsensitive(sourceText, evidence);
-}
-const GENERIC_ROLE_TOKENS = new Set([
-    'advisor', 'analyst', 'attendee', 'borrower', 'builder', 'buyer', 'candidate',
-    'capitalist', 'ceo', 'cfo', 'client', 'cmo', 'cofounder', 'collaborator',
-    'consultant', 'coo', 'creator', 'cto', 'customer', 'designer', 'developer',
-    'director', 'employer', 'engineer', 'entrepreneur', 'executive', 'expert',
-    'founder', 'funder', 'hire', 'hiring', 'investor', 'leader', 'lender',
-    'manager', 'mentor', 'operator', 'organizer', 'owner', 'partner', 'practitioner',
-    'professional', 'provider', 'recruiter', 'researcher', 'scientist', 'seller',
-    'speaker', 'specialist', 'sponsor', 'strategist', 'supplier', 'technologist',
-    'vendor', 'vp',
-]);
-const GENERIC_ROLE_MODIFIERS = new Set([
-    'business', 'co', 'commercial', 'community', 'creative', 'early', 'experienced',
-    'growth', 'independent', 'industry', 'junior', 'lead', 'local', 'nonprofit',
-    'operations', 'product', 'professional', 'public', 'senior', 'stage',
-    'startup', 'technical', 'venture',
-]);
-function roleTokens(role) {
-    return role.toLowerCase().match(/[\p{L}\p{M}\d]+/gu) ?? [];
-}
-function hasUnsupportedSourceRoleMaterial(role, evidence) {
-    const substantiveTokens = roleTokens(role).filter((token) => !GENERIC_ROLE_MODIFIERS.has(token));
-    return substantiveTokens.length === 0
-        || substantiveTokens.some((token) => !containsAlphanumericSpanCaseInsensitive(evidence, token));
-}
-function hasUnsupportedCounterpartRoleMaterial(role, evidence) {
-    return roleTokens(role).some((token) => !GENERIC_ROLE_TOKENS.has(token)
-        && !GENERIC_ROLE_MODIFIERS.has(token)
-        && !containsAlphanumericSpanCaseInsensitive(evidence, token));
-}
-/**
- * Remove frame elements that cross the source-evidence boundary. Structured
- * payloads must occur inside their evidence span. Source roles require grounded
- * substantive tokens; counterpart roles may add generic inferred role language.
- */
-export function sanitizeHydeSourceFrame(sourceText, frame) {
-    const grounded = (items) => items.filter((item) => hasExactEvidence(sourceText, item.evidence));
-    return {
-        sourceRoles: grounded(frame.sourceRoles)
-            .filter((item) => !hasUnsupportedSourceRoleMaterial(item.role, item.evidence)),
-        counterpartRoles: grounded(frame.counterpartRoles)
-            .filter((item) => !hasUnsupportedCounterpartRoleMaterial(item.role, item.evidence)),
-        hardConstraints: grounded(frame.hardConstraints)
-            .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.value)),
-        namedEntities: grounded(frame.namedEntities)
-            .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.name)),
-        domainVocabulary: grounded(frame.domainVocabulary)
-            .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.term)),
-    };
-}

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

@@ -1,38 +0,0 @@
-/**
- * HyDE Generator Agent: pure LLM agent for generating hypothetical documents
- * in the target corpus voice. Uses free-text lens labels instead of enum strategies.
- */
-import type { BaseLanguageModelInput } from '@langchain/core/language_models/base';
-import type { HydeSourceFrame } from './hyde.frame.js';
-import type { HydeTargetCorpus } from './lens.inferrer.js';
-export interface HydeGeneratorOutput {
-    text: string;
-}
-export interface HydeGenerateInput {
-    /** Original intent or query text. */
-    sourceText: string;
-    /** Free-text lens label from LensInferrer (e.g. "crypto infra VC"). */
-    lens: string;
-    /** Which corpus voice to generate in. */
-    corpus: HydeTargetCorpus;
-    /** Sanitized source-grounded frame. Absence preserves the exact legacy prompt. */
-    sourceFrame?: HydeSourceFrame;
-}
-/** Minimal structured model contract used for deterministic injection in tests. */
-export interface HydeGeneratorStructuredModel {
-    invoke(input: BaseLanguageModelInput, config?: {
-        signal?: AbortSignal;
-    }): Promise<unknown>;
-}
-/** Build the frame-v1 generation prompt from sanitized source evidence. */
-export declare function buildFrameHydePrompt(input: HydeGenerateInput & {
-    sourceFrame: HydeSourceFrame;
-}): string;
-/** Generates hypothetical documents in a target corpus voice for semantic search. */
-export declare class HydeGenerator {
-    private model?;
-    constructor(model?: HydeGeneratorStructuredModel);
-    private getModel;
-    /** Generate a hypothetical document for the given source text and lens. */
-    generate(input: HydeGenerateInput): Promise<HydeGeneratorOutput>;
-}

package/dist/discovery/hyde.generator.js

@@ -1,103 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-import { HumanMessage, SystemMessage } from '@langchain/core/messages';
-import { z } from 'zod';
-import { createStructuredModel } from "../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
-import { protocolLogger } from '../shared/observability/protocol.logger.js';
-import { Timed } from "../shared/observability/performance.js";
-import { HYDE_CORPUS_PROMPTS } from './hyde.strategies.js';
-const logger = protocolLogger("HydeGenerator");
-const SYSTEM_PROMPT = `You are a Hypothetical Document Generator for semantic search.
-
-Your task: Given a source statement (e.g. an intent or goal), write a short hypothetical document in the voice of the TARGET side—the kind of person or statement that would be an ideal match for that source.
-
-Rules:
-- Write in first person as the target.
-- Be concrete and specific so the text is good for vector similarity search.
-- Output only the hypothetical document text, no meta-commentary.
-- Keep length to a few sentences or one short paragraph.`;
-const responseFormat = z.object({
-    hypotheticalDocument: z
-        .string()
-        .describe('The hypothetical document text in the target voice, suitable for embedding and retrieval'),
-});
-function renderList(items) {
-    return items.length > 0 ? items.join('; ') : '(none)';
-}
-/** Build the frame-v1 generation prompt from sanitized source evidence. */
-export function buildFrameHydePrompt(input) {
-    const { sourceText, corpus, sourceFrame } = input;
-    const corpusInstruction = {
-        profiles: 'Write a first-person professional biography in the target profile voice.',
-        intents: 'Write a first-person goal or aspiration in the target intent voice.',
-        premises: 'Write a first-person stable identity, values, or worldview statement in the target premise voice.',
-    }[corpus];
-    return `${corpusInstruction}
-
-Source text: "${sourceText}"
-
-Sanitized source frame:
-- Source roles: ${renderList(sourceFrame.sourceRoles.map((item) => `${item.role} [evidence: "${item.evidence}"]`))}
-- Counterpart/complementary roles: ${renderList(sourceFrame.counterpartRoles.map((item) => `${item.role} [evidence: "${item.evidence}"]`))}
-- Explicit hard constraints: ${renderList(sourceFrame.hardConstraints.map((item) => `${item.type}: ${item.value} [evidence: "${item.evidence}"]`))}
-- Named entities: ${renderList(sourceFrame.namedEntities.map((item) => `${item.type}: ${item.name} [evidence: "${item.evidence}"]`))}
-- Domain vocabulary: ${renderList(sourceFrame.domainVocabulary.map((item) => `${item.term} [evidence: "${item.evidence}"]`))}
-
-Generation constraints:
-- You MAY elaborate generic roles and generic domain language.
-- You MAY use reciprocal/complementary inversion and write in the target voice.
-- You MUST NOT introduce any new proper noun or named entity.
-- You MUST NOT introduce any new hard location, time, numeric, credential, organization, or exclusivity constraint.
-- Preserve explicit source-frame constraints when they apply to the reciprocal target.
-- Output only a few sentences or one short paragraph.`;
-}
-/** Generates hypothetical documents in a target corpus voice for semantic search. */
-export class HydeGenerator {
-    constructor(model) {
-        // Preserve the legacy production model construction path; injected models
-        // keep prompt tests provider-free.
-        this.model = model ?? createStructuredModel("hydeGenerator", responseFormat, {
-            name: "hyde_generator",
-        });
-    }
-    getModel() {
-        this.model ?? (this.model = createStructuredModel("hydeGenerator", responseFormat, {
-            name: "hyde_generator",
-        }));
-        return this.model;
-    }
-    /** Generate a hypothetical document for the given source text and lens. */
-    async generate(input) {
-        const promptText = input.sourceFrame
-            ? buildFrameHydePrompt(input)
-            : HYDE_CORPUS_PROMPTS[input.corpus](input.sourceText, input.lens);
-        const messages = [
-            new SystemMessage(SYSTEM_PROMPT),
-            new HumanMessage(promptText),
-        ];
-        const result = await invokeWithAbortSignal(this.getModel(), messages);
-        const parsed = responseFormat.parse(result);
-        const text = parsed.hypotheticalDocument ?? '';
-        logger.verbose('Generated HyDE document', {
-            lens: input.lens,
-            corpus: input.corpus,
-            textLength: text.length,
-            frameConstrained: !!input.sourceFrame,
-        });
-        return { text };
-    }
-}
-__decorate([
-    Timed(),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", Promise)
-], HydeGenerator.prototype, "generate", null);

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

@@ -1,209 +0,0 @@
-import type { DebugMetaAgent } from '../agents/agent.module.js';
-import type { HydeCache } from '../shared/interfaces/cache.interface.js';
-import type { HydeGraphDatabase } from '../shared/interfaces/database.interface.js';
-import type { EmbeddingGenerator } from '../shared/interfaces/embedder.interface.js';
-import { type HydeGenerationMode } from './hyde.env.js';
-import { type HydeSourceFrame } from './hyde.frame.js';
-import type { HydeGenerateInput, HydeGeneratorOutput } from './hyde.generator.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. */
-export interface HydeLensInferrerLike {
-    infer(input: LensInferenceInput): Promise<LensInferenceOutput>;
-}
-/** Narrow document generator contract accepted by the graph. */
-export interface HydeGeneratorLike {
-    generate(input: HydeGenerateInput): Promise<HydeGeneratorOutput>;
-}
-/** Narrow batch validator contract accepted by the graph. */
-export interface HydeValidatorLike {
-    validate(input: HydeValidationInput): Promise<HydeValidationOutput>;
-}
-export interface HydeGraphOptions {
-    /** Test override. Production derives the mode from HYDE_FRAME_CONSTRAINTS_ENABLED. */
-    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 {
-    /** 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.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined;
-        sourceText: string;
-        profileContext: string | undefined;
-        maxLenses: number;
-        forceRegenerate: boolean;
-        lenses: import("./lens.inferrer.js").Lens[];
-        sourceFrame: HydeSourceFrame | undefined;
-        frameFingerprint: string | undefined;
-        sourceTextHash: string | undefined;
-        generatedAt: string | undefined;
-        hydeDocuments: Record<string, HydeDocumentState>;
-        hydeEmbeddings: Record<string, number[]>;
-        error: string | undefined;
-        agentTimings: DebugMetaAgent[];
-    }, {
-        sourceType?: "intent" | "context" | "query" | 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;
-        forceRegenerate?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
-        lenses?: import("./lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("./lens.inferrer.js").Lens[]> | undefined;
-        sourceFrame?: HydeSourceFrame | import("@langchain/langgraph").OverwriteValue<HydeSourceFrame | undefined> | undefined;
-        frameFingerprint?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-        sourceTextHash?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-        generatedAt?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-        hydeDocuments?: Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>> | undefined;
-        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__" | "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.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>;
-            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
-        };
-        profileContext: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        maxLenses: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        forceRegenerate: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
-        lenses: import("@langchain/langgraph").BaseChannel<import("./lens.inferrer.js").Lens[], import("./lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("./lens.inferrer.js").Lens[]>, unknown>;
-        sourceFrame: import("@langchain/langgraph").BaseChannel<HydeSourceFrame | undefined, HydeSourceFrame | import("@langchain/langgraph").OverwriteValue<HydeSourceFrame | undefined> | undefined, unknown>;
-        frameFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        sourceTextHash: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        generatedAt: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        hydeDocuments: import("@langchain/langgraph").BaseChannel<Record<string, HydeDocumentState>, Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>>, unknown>;
-        hydeEmbeddings: import("@langchain/langgraph").BaseChannel<Record<string, number[]>, Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>>, unknown>;
-        error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
-    }, {
-        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.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>;
-            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
-        };
-        profileContext: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        maxLenses: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-        forceRegenerate: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
-        lenses: import("@langchain/langgraph").BaseChannel<import("./lens.inferrer.js").Lens[], import("./lens.inferrer.js").Lens[] | import("@langchain/langgraph").OverwriteValue<import("./lens.inferrer.js").Lens[]>, unknown>;
-        sourceFrame: import("@langchain/langgraph").BaseChannel<HydeSourceFrame | undefined, HydeSourceFrame | import("@langchain/langgraph").OverwriteValue<HydeSourceFrame | undefined> | undefined, unknown>;
-        frameFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        sourceTextHash: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        generatedAt: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        hydeDocuments: import("@langchain/langgraph").BaseChannel<Record<string, HydeDocumentState>, Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>>, unknown>;
-        hydeEmbeddings: import("@langchain/langgraph").BaseChannel<Record<string, number[]>, Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>>, unknown>;
-        error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
-    }, import("@langchain/langgraph").StateDefinition, {
-        infer_lenses: {
-            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;
-        };
-        check_cache: {
-            hydeDocuments: {
-                [k: string]: HydeDocumentState;
-            };
-        };
-        generate_missing: {
-            hydeDocuments: {
-                [x: string]: HydeDocumentState;
-            };
-            agentTimings: DebugMetaAgent[];
-        };
-        embed: {
-            hydeDocuments: Record<string, HydeDocumentState>;
-            hydeEmbeddings: Record<string, number[]>;
-        };
-        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;