@indexnetwork/protocol 0.1.0

package/dist/states/intent.state.d.ts

@@ -0,0 +1,203 @@
+import { BaseMessage } from "@langchain/core/messages";
+import { InferredIntent } from "../agents/intent.inferrer.js";
+import { SemanticVerifierOutput } from "../agents/intent.verifier.js";
+import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+/**
+ * Extended InferredIntent that includes verification results.
+ * We attach the verification output directly to the intent object
+ * as it flows through the graph.
+ */
+export type VerifiedIntent = InferredIntent & {
+    verification?: SemanticVerifierOutput;
+    score?: number;
+};
+/**
+ * Result of executing a single reconciler action.
+ */
+export interface ExecutionResult {
+    /** The action type that was executed */
+    actionType: 'create' | 'update' | 'expire';
+    /** Whether the action succeeded */
+    success: boolean;
+    /** The intent ID (created/updated/archived) */
+    intentId?: string;
+    /** Final payload (sanitized, for create/update) */
+    payload?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * The Graph State using LangGraph Annotations.
+ * This acts as the central bus for data flowing through our graph.
+ */
+export declare const IntentGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /**
+     * The unique identifier of the user whose intents are being processed.
+     * Required for database operations.
+     */
+    userId: {
+        (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>;
+    };
+    /**
+     * The user's profile context (Identity, Narrative, etc.)
+     */
+    userProfile: {
+        (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>;
+    };
+    /**
+     * Explicit input content (e.g., user message).
+     * Optional - graph might run on implicit only.
+     */
+    inputContent: {
+        (annotation: import("@langchain/langgraph").SingleReducer<string | undefined, string | undefined>): import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        (): import("@langchain/langgraph").LastValue<string | undefined>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    /**
+     * Conversation history for context-aware intent inference.
+     * Used to resolve anaphoric references ("that intent", "this goal").
+     * Limited to recent messages (typically last 10) for token efficiency.
+     * Optional - if not provided, intent inference uses only inputContent.
+     */
+    conversationContext: import("@langchain/langgraph").BaseChannel<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined, BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined> | undefined, unknown>;
+    /**
+     * Operation mode controls graph flow and determines which nodes execute.
+     * - 'create': Full pipeline (prep → inference → verification → reconciliation → execution)
+     * - 'update': Skip verification if no new intents (prep → inference → reconciliation → execution)
+     * - 'delete': Skip inference and verification (prep → reconciliation → execution)
+     * - 'read': Fast path (prep → queryNode → END) — reads intents without LLM calls
+     * - 'propose': Inference + verification only, stops before reconciliation (no DB writes)
+     *
+     * Defaults to 'create' for backward compatibility.
+     */
+    operationMode: import("@langchain/langgraph").BaseChannel<"create" | "update" | "delete" | "read" | "propose", "create" | "update" | "delete" | "read" | "propose" | import("@langchain/langgraph").OverwriteValue<"create" | "update" | "delete" | "read" | "propose">, unknown>;
+    /**
+     * For update/delete operations, specifies which intent IDs to target.
+     * Optional - used when modifying or removing specific intents.
+     */
+    targetIntentIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+    /**
+     * Optional index scope (index ID). Used for linking created intents to an index
+     * and for scoping read operations. Prep always fetches ALL user intents via
+     * getActiveIntents(userId) regardless of index scope (for global dedup/reconciliation).
+     */
+    indexId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * The formatted string of currently active intents.
+     * Always populated by prep via getActiveIntents(userId).
+     */
+    activeIntents: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+    /**
+     * List of raw intents extracted from text.
+     */
+    inferredIntents: import("@langchain/langgraph").BaseChannel<{
+        reasoning: string;
+        confidence: "low" | "medium" | "high";
+        type: "goal" | "tombstone";
+        description: string;
+    }[], {
+        reasoning: string;
+        confidence: "low" | "medium" | "high";
+        type: "goal" | "tombstone";
+        description: string;
+    }[] | import("@langchain/langgraph").OverwriteValue<{
+        reasoning: string;
+        confidence: "low" | "medium" | "high";
+        type: "goal" | "tombstone";
+        description: string;
+    }[]>, unknown>;
+    /**
+     * List of intents that have passed semantic verification.
+     * Invalid intents are filtered out before reaching this state.
+     */
+    verifiedIntents: import("@langchain/langgraph").BaseChannel<VerifiedIntent[], VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<VerifiedIntent[]>, unknown>;
+    /**
+     * Final actions to be performed on the DB (Create, Update, Expire).
+     */
+    actions: import("@langchain/langgraph").BaseChannel<import("../agents/intent.reconciler.js").NormalizedIntentAction[], import("../agents/intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../agents/intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+    /**
+     * Results of executing actions against the database.
+     * Populated by executorNode after actions are persisted.
+     */
+    executionResults: import("@langchain/langgraph").BaseChannel<ExecutionResult[], ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<ExecutionResult[]>, unknown>;
+    /**
+     * If set, indicates a fatal error that should short-circuit the graph to END.
+     * Populated by prep when a precondition fails (e.g. missing profile).
+     */
+    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Accumulated trace entries from each graph node.
+     * Used for observability: surfaces internal processing steps (inference,
+     * verification with Felicity scores, reconciliation) to the frontend.
+     */
+    trace: import("@langchain/langgraph").BaseChannel<{
+        node: string;
+        detail?: string;
+        data?: Record<string, unknown>;
+    }[], {
+        node: string;
+        detail?: string;
+        data?: Record<string, unknown>;
+    }[] | import("@langchain/langgraph").OverwriteValue<{
+        node: string;
+        detail?: string;
+        data?: Record<string, unknown>;
+    }[]>, unknown>;
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
+    /**
+     * For read mode: filter intents by a specific user when reading in an index.
+     * When omitted and index-scoped, returns all intents in the index.
+     */
+    queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * For read mode: when true, return all of the current user's intents
+     * ignoring index scope. Used before create_intent to detect duplicates.
+     */
+    allUserIntents: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /**
+     * Output of read mode: queried intents with count and optional metadata.
+     */
+    readResult: import("@langchain/langgraph").BaseChannel<{
+        count: number;
+        intents: Array<{
+            id: string;
+            description: string;
+            summary: string | null;
+            createdAt: Date;
+            userId?: string;
+            userName?: string | null;
+        }>;
+        message?: string;
+        indexId?: string;
+    } | undefined, {
+        count: number;
+        intents: Array<{
+            id: string;
+            description: string;
+            summary: string | null;
+            createdAt: Date;
+            userId?: string;
+            userName?: string | null;
+        }>;
+        message?: string;
+        indexId?: string;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        count: number;
+        intents: Array<{
+            id: string;
+            description: string;
+            summary: string | null;
+            createdAt: Date;
+            userId?: string;
+            userName?: string | null;
+        }>;
+        message?: string;
+        indexId?: string;
+    } | undefined> | undefined, unknown>;
+}>;
+//# sourceMappingURL=intent.state.d.ts.map

package/dist/states/intent.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.state.d.ts","sourceRoot":"","sources":["../../src/states/intent.state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAG3B;;;OAGG;;;;;;IAGH;;OAEG;;;;;;IAGH;;;OAGG;;;;;;IAGH;;;;;OAKG;;IAMH;;;;;;;;;OASG;;IAMH;;;OAGG;;IAMH;;;;OAIG;;IAQH;;;OAGG;;IAQH;;OAEG;;;;;;;;;;;;;;;;;IAMH;;;OAGG;;IAQH;;OAEG;;IAMH;;;OAGG;;IAQH;;;OAGG;;IAQH;;;;OAIG;;cAC6B,MAAM;iBAAW,MAAM;eAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;cAAvD,MAAM;iBAAW,MAAM;eAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;cAAvD,MAAM;iBAAW,MAAM;eAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;IAKvF,sEAAsE;;IAQtE;;;OAGG;;IAMH;;;OAGG;;IAMH;;OAEG;;eAEM,MAAM;iBACJ,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC1B,CAAC;kBACQ,MAAM;kBACN,MAAM;;eAVT,MAAM;iBACJ,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC1B,CAAC;kBACQ,MAAM;kBACN,MAAM;;eAVT,MAAM;iBACJ,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC1B,CAAC;kBACQ,MAAM;kBACN,MAAM;;EAKlB,CAAC"}

package/dist/states/intent.state.js

@@ -0,0 +1,153 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * The Graph State using LangGraph Annotations.
+ * This acts as the central bus for data flowing through our graph.
+ */
+export const IntentGraphState = Annotation.Root({
+    // --- Inputs (Required at start) ---
+    /**
+     * The unique identifier of the user whose intents are being processed.
+     * Required for database operations.
+     */
+    userId: (Annotation),
+    /**
+     * The user's profile context (Identity, Narrative, etc.)
+     */
+    userProfile: (Annotation),
+    /**
+     * Explicit input content (e.g., user message).
+     * Optional - graph might run on implicit only.
+     */
+    inputContent: (Annotation),
+    /**
+     * Conversation history for context-aware intent inference.
+     * Used to resolve anaphoric references ("that intent", "this goal").
+     * Limited to recent messages (typically last 10) for token efficiency.
+     * Optional - if not provided, intent inference uses only inputContent.
+     */
+    conversationContext: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Operation mode controls graph flow and determines which nodes execute.
+     * - 'create': Full pipeline (prep → inference → verification → reconciliation → execution)
+     * - 'update': Skip verification if no new intents (prep → inference → reconciliation → execution)
+     * - 'delete': Skip inference and verification (prep → reconciliation → execution)
+     * - 'read': Fast path (prep → queryNode → END) — reads intents without LLM calls
+     * - 'propose': Inference + verification only, stops before reconciliation (no DB writes)
+     *
+     * Defaults to 'create' for backward compatibility.
+     */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'create',
+    }),
+    /**
+     * For update/delete operations, specifies which intent IDs to target.
+     * Optional - used when modifying or removing specific intents.
+     */
+    targetIntentIds: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Optional index scope (index ID). Used for linking created intents to an index
+     * and for scoping read operations. Prep always fetches ALL user intents via
+     * getActiveIntents(userId) regardless of index scope (for global dedup/reconciliation).
+     */
+    indexId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    // --- Populated by Graph (Prep Node) ---
+    /**
+     * The formatted string of currently active intents.
+     * Always populated by prep via getActiveIntents(userId).
+     */
+    activeIntents: Annotation({
+        reducer: (curr, next) => next,
+        default: () => "",
+    }),
+    // --- Intermediate State ---
+    /**
+     * List of raw intents extracted from text.
+     */
+    inferredIntents: Annotation({
+        reducer: (curr, next) => next, // Overwrite with new inference
+        default: () => [],
+    }),
+    /**
+     * List of intents that have passed semantic verification.
+     * Invalid intents are filtered out before reaching this state.
+     */
+    verifiedIntents: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    // --- Output ---
+    /**
+     * Final actions to be performed on the DB (Create, Update, Expire).
+     */
+    actions: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    /**
+     * Results of executing actions against the database.
+     * Populated by executorNode after actions are persisted.
+     */
+    executionResults: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    // --- Error State ---
+    /**
+     * If set, indicates a fatal error that should short-circuit the graph to END.
+     * Populated by prep when a precondition fails (e.g. missing profile).
+     */
+    error: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    // --- Trace Output ---
+    /**
+     * Accumulated trace entries from each graph node.
+     * Used for observability: surfaces internal processing steps (inference,
+     * verification with Felicity scores, reconciliation) to the frontend.
+     */
+    trace: Annotation({
+        reducer: (curr, next) => [...curr, ...(next || [])],
+        default: () => [],
+    }),
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: Annotation({
+        reducer: (acc, val) => [...acc, ...val],
+        default: () => [],
+    }),
+    // --- Read Mode Fields ---
+    /**
+     * For read mode: filter intents by a specific user when reading in an index.
+     * When omitted and index-scoped, returns all intents in the index.
+     */
+    queryUserId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * For read mode: when true, return all of the current user's intents
+     * ignoring index scope. Used before create_intent to detect duplicates.
+     */
+    allUserIntents: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    /**
+     * Output of read mode: queried intents with count and optional metadata.
+     */
+    readResult: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+});
+//# sourceMappingURL=intent.state.js.map

package/dist/states/intent.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.state.js","sourceRoot":"","sources":["../../src/states/intent.state.ts"],"names":[],"mappings":"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"}

package/dist/states/intent_index.state.d.ts

@@ -0,0 +1,148 @@
+import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+/**
+ * Intent payload and metadata loaded for index evaluation.
+ * (Migrated from the old index.graph.state.ts)
+ */
+export interface IntentForIndexing {
+    id: string;
+    payload: string;
+    userId: string;
+    sourceType: string | null;
+    sourceId: string | null;
+}
+/**
+ * Index and member prompts for a single index (user must be member with autoAssign).
+ * (Migrated from the old index.graph.state.ts)
+ */
+export interface IndexMemberContext {
+    indexId: string;
+    indexPrompt: string | null;
+    memberPrompt: string | null;
+}
+/**
+ * Result of executing an assignment decision.
+ * (Migrated from the old index.graph.state.ts)
+ */
+export interface AssignmentResult {
+    indexId: string;
+    assigned: boolean;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Intent Index Graph State.
+ * Handles CRUD for the intent_indexes junction table (linking intents to indexes).
+ * Absorbs the old Index Graph's evaluate-based assignment flow.
+ *
+ * Flow:
+ * START → router → {
+ *   create: assignNode (direct or evaluated) → END
+ *   read: readNode → END
+ *   delete: unassignNode → END
+ * }
+ */
+export declare const IntentIndexGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /** User performing the action. Always required. */
+    userId: {
+        (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>;
+    };
+    /** Target index for assign/read-by-index. From ChatGraph or tool arg. */
+    indexId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Target intent for assign/read-by-intent. From tool arg. */
+    intentId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Operation mode. */
+    operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+    /**
+     * When true, skip LLM evaluation and assign directly.
+     * (Migrated from old Index Graph.)
+     */
+    skipEvaluation: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Intent payload and metadata. Null if intent not found. */
+    intent: import("@langchain/langgraph").BaseChannel<IntentForIndexing | null, IntentForIndexing | import("@langchain/langgraph").OverwriteValue<IntentForIndexing | null> | null, unknown>;
+    /** Index + member context. Null if user not eligible. */
+    indexContext: import("@langchain/langgraph").BaseChannel<IndexMemberContext | null, IndexMemberContext | import("@langchain/langgraph").OverwriteValue<IndexMemberContext | null> | null, unknown>;
+    /** LLM evaluation result. Null if skipped. */
+    evaluation: import("@langchain/langgraph").BaseChannel<{
+        reasoning: string;
+        indexScore: number;
+        memberScore: number;
+    } | null, {
+        reasoning: string;
+        indexScore: number;
+        memberScore: number;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        reasoning: string;
+        indexScore: number;
+        memberScore: number;
+    } | null> | null, unknown>;
+    /** Final decision: should intent be in this index? */
+    shouldAssign: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
+    /** Final score used for decision (0–1). */
+    finalScore: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+    /** Result of the assignment operation. */
+    assignmentResult: import("@langchain/langgraph").BaseChannel<AssignmentResult | null, AssignmentResult | import("@langchain/langgraph").OverwriteValue<AssignmentResult | null> | null, unknown>;
+    /** For read-by-intent: pass userId when listing an intent's indexes (omit for read-by-index). */
+    queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Output for read mode. */
+    readResult: import("@langchain/langgraph").BaseChannel<{
+        links: Array<{
+            intentId: string;
+            indexId: string;
+            intentTitle?: string;
+            indexTitle?: string;
+            userId?: string;
+            userName?: string;
+            createdAt?: Date;
+        }>;
+        count: number;
+        mode: string;
+        note?: string;
+    } | undefined, {
+        links: Array<{
+            intentId: string;
+            indexId: string;
+            intentTitle?: string;
+            indexTitle?: string;
+            userId?: string;
+            userName?: string;
+            createdAt?: Date;
+        }>;
+        count: number;
+        mode: string;
+        note?: string;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        links: Array<{
+            intentId: string;
+            indexId: string;
+            intentTitle?: string;
+            indexTitle?: string;
+            userId?: string;
+            userName?: string;
+            createdAt?: Date;
+        }>;
+        count: number;
+        mode: string;
+        note?: string;
+    } | undefined> | undefined, unknown>;
+    /** Output for create/delete modes. */
+    mutationResult: import("@langchain/langgraph").BaseChannel<{
+        success: boolean;
+        message?: string;
+        error?: string;
+    } | undefined, {
+        success: boolean;
+        message?: string;
+        error?: string;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        success: boolean;
+        message?: string;
+        error?: string;
+    } | undefined> | undefined, unknown>;
+    /** Error message. */
+    error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
+}>;
+//# sourceMappingURL=intent_index.state.d.ts.map

package/dist/states/intent_index.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent_index.state.d.ts","sourceRoot":"","sources":["../../src/states/intent_index.state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB;IAGhC,mDAAmD;;;;;;IAGnD,yEAAyE;;IAMzE,8DAA8D;;IAM9D,sBAAsB;;IAQtB;;;OAGG;;IAQH,6DAA6D;;IAM7D,yDAAyD;;IAMzD,8CAA8C;;;;;;;;;;;;;;IAM9C,sDAAsD;;IAMtD,2CAA2C;;IAM3C,0CAA0C;;IAQ1C,iGAAiG;;IAMjG,4BAA4B;;eAEnB,KAAK,CAAC;YACX,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,IAAI,CAAC;SAClB,CAAC;eACK,MAAM;cACP,MAAM;eACL,MAAM;;eAXN,KAAK,CAAC;YACX,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,IAAI,CAAC;SAClB,CAAC;eACK,MAAM;cACP,MAAM;eACL,MAAM;;eAXN,KAAK,CAAC;YACX,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,IAAI,CAAC;SAClB,CAAC;eACK,MAAM;cACP,MAAM;eACL,MAAM;;IAMf,sCAAsC;;iBAE3B,OAAO;kBACN,MAAM;gBACR,MAAM;;iBAFL,OAAO;kBACN,MAAM;gBACR,MAAM;;iBAFL,OAAO;kBACN,MAAM;gBACR,MAAM;;IAMhB,qBAAqB;;IAMrB,sEAAsE;;EAKtE,CAAC"}

package/dist/states/intent_index.state.js

@@ -0,0 +1,100 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * Intent Index Graph State.
+ * Handles CRUD for the intent_indexes junction table (linking intents to indexes).
+ * Absorbs the old Index Graph's evaluate-based assignment flow.
+ *
+ * Flow:
+ * START → router → {
+ *   create: assignNode (direct or evaluated) → END
+ *   read: readNode → END
+ *   delete: unassignNode → END
+ * }
+ */
+export const IntentIndexGraphState = Annotation.Root({
+    // --- Core Inputs (from ChatGraph via ToolContext) ---
+    /** User performing the action. Always required. */
+    userId: (Annotation),
+    /** Target index for assign/read-by-index. From ChatGraph or tool arg. */
+    indexId: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Target intent for assign/read-by-intent. From tool arg. */
+    intentId: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Operation mode. */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'read',
+    }),
+    // --- Create Mode Controls ---
+    /**
+     * When true, skip LLM evaluation and assign directly.
+     * (Migrated from old Index Graph.)
+     */
+    skipEvaluation: Annotation({
+        reducer: (_, next) => next,
+        default: () => true,
+    }),
+    // --- Intermediate State (populated by nodes, migrated from old Index Graph) ---
+    /** Intent payload and metadata. Null if intent not found. */
+    intent: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+    /** Index + member context. Null if user not eligible. */
+    indexContext: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+    /** LLM evaluation result. Null if skipped. */
+    evaluation: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+    /** Final decision: should intent be in this index? */
+    shouldAssign: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Final score used for decision (0–1). */
+    finalScore: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Result of the assignment operation. */
+    assignmentResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+    // --- Read Mode Outputs ---
+    /** For read-by-intent: pass userId when listing an intent's indexes (omit for read-by-index). */
+    queryUserId: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Output for read mode. */
+    readResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Output for create/delete modes. */
+    mutationResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Error message. */
+    error: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: Annotation({
+        reducer: (acc, val) => [...acc, ...val],
+        default: () => [],
+    }),
+});
+//# sourceMappingURL=intent_index.state.js.map

package/dist/states/intent_index.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent_index.state.js","sourceRoot":"","sources":["../../src/states/intent_index.state.ts"],"names":[],"mappings":"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"}