@indexnetwork/protocol 0.1.0

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

@@ -0,0 +1,54 @@
+/**
+ * HyDE Graph state: cache-aware hypothetical document generation.
+ * Used by the HyDE graph for infer_lenses → check_cache → generate_missing → embed → cache_results.
+ */
+import type { Id } from '../interfaces/database.interface.js';
+import type { Lens, HydeTargetCorpus } from '../agents/lens.inferrer.js';
+import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+/** Single HyDE document (text + embedding) for one lens. */
+export interface HydeDocumentState {
+    lens: string;
+    targetCorpus: HydeTargetCorpus;
+    hydeText: string;
+    hydeEmbedding: number[];
+}
+/** State for the HyDE generation graph. */
+export declare const HydeGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /** Source type: intent, profile, or ad-hoc query. */
+    sourceType: {
+        (annotation: import("@langchain/langgraph").SingleReducer<"profile" | "intent" | "query", "profile" | "intent" | "query">): import("@langchain/langgraph").BaseChannel<"profile" | "intent" | "query", "profile" | "intent" | "query" | import("@langchain/langgraph").OverwriteValue<"profile" | "intent" | "query">, unknown>;
+        (): import("@langchain/langgraph").LastValue<"profile" | "intent" | "query">;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    /** Source entity ID (e.g. intent ID, user ID). Omitted for ad-hoc query. */
+    sourceId: import("@langchain/langgraph").BaseChannel<Id<"users"> | Id<"intents"> | undefined, Id<"users"> | Id<"intents"> | import("@langchain/langgraph").OverwriteValue<Id<"users"> | Id<"intents"> | undefined> | undefined, unknown>;
+    /** Source text to generate HyDE from (intent payload, profile summary, or query). */
+    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>;
+    };
+    /** Optional profile context for lens inference (user's profile summary). */
+    profileContext: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Maximum number of lenses to infer (default 3). */
+    maxLenses: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    /** When true, skip cache/DB and regenerate all lenses. */
+    forceRegenerate: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Inferred lenses from the LensInferrer agent. */
+    lenses: import("@langchain/langgraph").BaseChannel<Lens[], Lens[] | import("@langchain/langgraph").OverwriteValue<Lens[]>, unknown>;
+    /**
+     * HyDE documents per lens (from cache, DB, or newly generated).
+     * Keyed by lens label; values include hydeText and hydeEmbedding.
+     */
+    hydeDocuments: import("@langchain/langgraph").BaseChannel<Record<string, HydeDocumentState>, Record<string, HydeDocumentState> | import("@langchain/langgraph").OverwriteValue<Record<string, HydeDocumentState>>, unknown>;
+    /**
+     * Final embeddings per lens (convenience output for search).
+     * Populated by embed node; used by opportunity graph.
+     */
+    hydeEmbeddings: import("@langchain/langgraph").BaseChannel<Record<string, number[]>, Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>>, unknown>;
+    /** Non-fatal error message. */
+    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, 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=hyde.state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.state.d.ts","sourceRoot":"","sources":["../../src/states/hyde.state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,2CAA2C;AAC3C,eAAO,MAAM,cAAc;IAGzB,qDAAqD;;;;;;IAGrD,4EAA4E;;IAM5E,qFAAqF;;;;;;IAGrF,4EAA4E;;IAM5E,qDAAqD;;IAMrD,0DAA0D;;IAQ1D,mDAAmD;;IAMnD;;;OAGG;;IAMH;;;OAGG;;IAMH,+BAA+B;;IAM/B,sEAAsE;;EAKtE,CAAC"}

package/dist/states/hyde.state.js

@@ -0,0 +1,66 @@
+/**
+ * HyDE Graph state: cache-aware hypothetical document generation.
+ * Used by the HyDE graph for infer_lenses → check_cache → generate_missing → embed → cache_results.
+ */
+import { Annotation } from '@langchain/langgraph';
+/** State for the HyDE generation graph. */
+export const HydeGraphState = Annotation.Root({
+    // ─── Inputs ─────────────────────────────────────────────────────────────
+    /** Source type: intent, profile, or ad-hoc query. */
+    sourceType: (Annotation),
+    /** Source entity ID (e.g. intent ID, user ID). Omitted for ad-hoc query. */
+    sourceId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Source text to generate HyDE from (intent payload, profile summary, or query). */
+    sourceText: (Annotation),
+    /** Optional profile context for lens inference (user's profile summary). */
+    profileContext: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Maximum number of lenses to infer (default 3). */
+    maxLenses: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 3,
+    }),
+    /** When true, skip cache/DB and regenerate all lenses. */
+    forceRegenerate: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    // ─── Intermediate / output ─────────────────────────────────────────────
+    /** Inferred lenses from the LensInferrer agent. */
+    lenses: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    /**
+     * HyDE documents per lens (from cache, DB, or newly generated).
+     * Keyed by lens label; values include hydeText and hydeEmbedding.
+     */
+    hydeDocuments: Annotation({
+        reducer: (curr, next) => (next ? { ...curr, ...next } : curr),
+        default: () => ({}),
+    }),
+    /**
+     * Final embeddings per lens (convenience output for search).
+     * Populated by embed node; used by opportunity graph.
+     */
+    hydeEmbeddings: Annotation({
+        reducer: (curr, next) => (next ? { ...curr, ...next } : curr),
+        default: () => ({}),
+    }),
+    /** Non-fatal error message. */
+    error: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: Annotation({
+        reducer: (acc, val) => [...acc, ...val],
+        default: () => [],
+    }),
+});
+//# sourceMappingURL=hyde.state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.state.js","sourceRoot":"","sources":["../../src/states/hyde.state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAalD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAC5C,2EAA2E;IAE3E,qDAAqD;IACrD,UAAU,EAAE,CAAA,UAA0C,CAAA;IAEtD,4EAA4E;IAC5E,QAAQ,EAAE,UAAU,CAA0C;QAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,qFAAqF;IACrF,UAAU,EAAE,CAAA,UAAkB,CAAA;IAE9B,4EAA4E;IAC5E,cAAc,EAAE,UAAU,CAAqB;QAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,qDAAqD;IACrD,SAAS,EAAE,UAAU,CAAS;QAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;KACjB,CAAC;IAEF,0DAA0D;IAC1D,eAAe,EAAE,UAAU,CAAU;QACnC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;KACrB,CAAC;IAEF,0EAA0E;IAE1E,mDAAmD;IACnD,MAAM,EAAE,UAAU,CAAS;QACzB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;IAEF;;;OAGG;IACH,aAAa,EAAE,UAAU,CAAoC;QAC3D,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,cAAc,EAAE,UAAU,CAA2B;QACnD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB,CAAC;IAEF,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAqB;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,sEAAsE;IACtE,YAAY,EAAE,UAAU,CAAmB;QACzC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC;QACvC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;CACH,CAAC,CAAC"}

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

@@ -0,0 +1,179 @@
+/**
+ * Index Graph State.
+ * Handles CRUD operations for indexes (communities).
+ *
+ * Flow:
+ * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
+ */
+export declare const IndexGraphState: 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 ID. Required for read/update/delete. From ChatGraph or tool arg. */
+    indexId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Operation mode. */
+    operationMode: import("@langchain/langgraph").BaseChannel<"create" | "update" | "delete" | "read", "create" | "update" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "update" | "delete" | "read">, unknown>;
+    /** For create mode: index creation data. */
+    createInput: import("@langchain/langgraph").BaseChannel<{
+        title: string;
+        prompt?: string;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+    } | undefined, {
+        title: string;
+        prompt?: string;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+    } | import("@langchain/langgraph").OverwriteValue<{
+        title: string;
+        prompt?: string;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+    } | undefined> | undefined, unknown>;
+    /** For update mode: fields to update. */
+    updateInput: import("@langchain/langgraph").BaseChannel<{
+        title?: string;
+        prompt?: string | null;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+        allowGuestVibeCheck?: boolean;
+    } | undefined, {
+        title?: string;
+        prompt?: string | null;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+        allowGuestVibeCheck?: boolean;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        title?: string;
+        prompt?: string | null;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+        allowGuestVibeCheck?: boolean;
+    } | undefined> | undefined, unknown>;
+    /** When true and index-scoped, read returns all user indexes (not just scoped one). */
+    showAll: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Output for read mode. */
+    readResult: import("@langchain/langgraph").BaseChannel<{
+        memberOf: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            autoAssign: boolean;
+            joinedAt: Date;
+        }>;
+        owns: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            memberCount: number;
+            intentCount: number;
+            joinPolicy: string;
+        }>;
+        publicIndexes?: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            memberCount: number;
+            owner: {
+                name: string;
+                avatar: string | null;
+            } | null;
+        }>;
+        stats: {
+            memberOfCount: number;
+            ownsCount: number;
+            publicIndexesCount?: number;
+            scopeNote?: string;
+        };
+    } | undefined, {
+        memberOf: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            autoAssign: boolean;
+            joinedAt: Date;
+        }>;
+        owns: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            memberCount: number;
+            intentCount: number;
+            joinPolicy: string;
+        }>;
+        publicIndexes?: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            memberCount: number;
+            owner: {
+                name: string;
+                avatar: string | null;
+            } | null;
+        }>;
+        stats: {
+            memberOfCount: number;
+            ownsCount: number;
+            publicIndexesCount?: number;
+            scopeNote?: string;
+        };
+    } | import("@langchain/langgraph").OverwriteValue<{
+        memberOf: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            autoAssign: boolean;
+            joinedAt: Date;
+        }>;
+        owns: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            memberCount: number;
+            intentCount: number;
+            joinPolicy: string;
+        }>;
+        publicIndexes?: Array<{
+            indexId: string;
+            title: string;
+            description: string | null;
+            memberCount: number;
+            owner: {
+                name: string;
+                avatar: string | null;
+            } | null;
+        }>;
+        stats: {
+            memberOfCount: number;
+            ownsCount: number;
+            publicIndexesCount?: number;
+            scopeNote?: string;
+        };
+    } | undefined> | undefined, unknown>;
+    /** Output for create/update/delete modes. */
+    mutationResult: import("@langchain/langgraph").BaseChannel<{
+        success: boolean;
+        indexId?: string;
+        title?: string;
+        message?: string;
+        error?: string;
+    } | undefined, {
+        success: boolean;
+        indexId?: string;
+        title?: string;
+        message?: string;
+        error?: string;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        success: boolean;
+        indexId?: string;
+        title?: string;
+        message?: string;
+        error?: string;
+    } | undefined> | undefined, unknown>;
+    /** Error message if graph could not complete. */
+    error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+}>;
+//# sourceMappingURL=index.state.d.ts.map

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

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

package/dist/states/index.state.js

@@ -0,0 +1,56 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * Index Graph State.
+ * Handles CRUD operations for indexes (communities).
+ *
+ * Flow:
+ * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
+ */
+export const IndexGraphState = Annotation.Root({
+    // --- Core Inputs (from ChatGraph via ToolContext) ---
+    /** User performing the action. Always required. */
+    userId: (Annotation),
+    /** Target index ID. Required for read/update/delete. From ChatGraph or tool arg. */
+    indexId: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Operation mode. */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'read',
+    }),
+    // --- Mode-Specific Inputs ---
+    /** For create mode: index creation data. */
+    createInput: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** For update mode: fields to update. */
+    updateInput: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** When true and index-scoped, read returns all user indexes (not just scoped one). */
+    showAll: Annotation({
+        reducer: (_, next) => next,
+        default: () => false,
+    }),
+    // --- Outputs ---
+    /** Output for read mode. */
+    readResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Output for create/update/delete modes. */
+    mutationResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Error message if graph could not complete. */
+    error: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+});
+//# sourceMappingURL=index.state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.state.js","sourceRoot":"","sources":["../../src/states/index.state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC;IAC7C,uDAAuD;IAEvD,mDAAmD;IACnD,MAAM,EAAE,CAAA,UAAkB,CAAA;IAE1B,oFAAoF;IACpF,OAAO,EAAE,UAAU,CAAqB;QACtC,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,sBAAsB;IACtB,aAAa,EAAE,UAAU,CAA0C;QACjE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAe;KAC/B,CAAC;IAEF,+BAA+B;IAE/B,4CAA4C;IAC5C,WAAW,EAAE,UAAU,CAKR;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,yCAAyC;IACzC,WAAW,EAAE,UAAU,CAMR;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,uFAAuF;IACvF,OAAO,EAAE,UAAU,CAAU;QAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;KACrB,CAAC;IAEF,kBAAkB;IAElB,4BAA4B;IAC5B,UAAU,EAAE,UAAU,CA6BP;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,6CAA6C;IAC7C,cAAc,EAAE,UAAU,CAMX;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,iDAAiD;IACjD,KAAK,EAAE,UAAU,CAAgB;QAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;KACpB,CAAC;CACH,CAAC,CAAC"}

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

@@ -0,0 +1,77 @@
+/**
+ * Index Membership Graph State.
+ * Handles CRUD operations for index memberships (index_members table).
+ *
+ * Flow:
+ * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
+ */
+export declare const IndexMembershipGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /** User performing the action (the actor). 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. Required for all operations. */
+    indexId: {
+        (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>;
+    };
+    /** Operation mode. */
+    operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+    /** For create/delete: the user being added/removed. */
+    targetUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Output for read mode: list of members. */
+    readResult: import("@langchain/langgraph").BaseChannel<{
+        indexId: string;
+        count: number;
+        members: Array<{
+            userId: string;
+            name: string;
+            avatar: string | null;
+            permissions: string[];
+            intentCount: number;
+            joinedAt: Date;
+        }>;
+    } | undefined, {
+        indexId: string;
+        count: number;
+        members: Array<{
+            userId: string;
+            name: string;
+            avatar: string | null;
+            permissions: string[];
+            intentCount: number;
+            joinedAt: Date;
+        }>;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        indexId: string;
+        count: number;
+        members: Array<{
+            userId: string;
+            name: string;
+            avatar: string | null;
+            permissions: string[];
+            intentCount: number;
+            joinedAt: Date;
+        }>;
+    } | 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 if graph could not complete. */
+    error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+}>;
+//# sourceMappingURL=index_membership.state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index_membership.state.d.ts","sourceRoot":"","sources":["../../src/states/index_membership.state.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;IAGpC,+DAA+D;;;;;;IAG/D,iDAAiD;;;;;;IAGjD,sBAAsB;;IAQtB,uDAAuD;;IAQvD,6CAA6C;;iBAElC,MAAM;eACR,MAAM;iBACJ,KAAK,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;YACtB,WAAW,EAAE,MAAM,EAAE,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC;SAChB,CAAC;;iBATO,MAAM;eACR,MAAM;iBACJ,KAAK,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;YACtB,WAAW,EAAE,MAAM,EAAE,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC;SAChB,CAAC;;iBATO,MAAM;eACR,MAAM;iBACJ,KAAK,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;YACtB,WAAW,EAAE,MAAM,EAAE,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC;SAChB,CAAC;;IAMJ,sCAAsC;;iBAE3B,OAAO;kBACN,MAAM;gBACR,MAAM;;iBAFL,OAAO;kBACN,MAAM;gBACR,MAAM;;iBAFL,OAAO;kBACN,MAAM;gBACR,MAAM;;IAMhB,iDAAiD;;EAKjD,CAAC"}

package/dist/states/index_membership.state.js

@@ -0,0 +1,43 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * Index Membership Graph State.
+ * Handles CRUD operations for index memberships (index_members table).
+ *
+ * Flow:
+ * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
+ */
+export const IndexMembershipGraphState = Annotation.Root({
+    // --- Core Inputs (from ChatGraph via ToolContext) ---
+    /** User performing the action (the actor). Always required. */
+    userId: (Annotation),
+    /** Target index. Required for all operations. */
+    indexId: (Annotation),
+    /** Operation mode. */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'read',
+    }),
+    // --- Mode-Specific Inputs ---
+    /** For create/delete: the user being added/removed. */
+    targetUserId: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    // --- Outputs ---
+    /** Output for read mode: list of members. */
+    readResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Output for create/delete modes. */
+    mutationResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Error message if graph could not complete. */
+    error: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+});
+//# sourceMappingURL=index_membership.state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index_membership.state.js","sourceRoot":"","sources":["../../src/states/index_membership.state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC,IAAI,CAAC;IACvD,uDAAuD;IAEvD,+DAA+D;IAC/D,MAAM,EAAE,CAAA,UAAkB,CAAA;IAE1B,iDAAiD;IACjD,OAAO,EAAE,CAAA,UAAkB,CAAA;IAE3B,sBAAsB;IACtB,aAAa,EAAE,UAAU,CAA+B;QACtD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAe;KAC/B,CAAC;IAEF,+BAA+B;IAE/B,uDAAuD;IACvD,YAAY,EAAE,UAAU,CAAqB;QAC3C,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,kBAAkB;IAElB,6CAA6C;IAC7C,UAAU,EAAE,UAAU,CAWP;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,sCAAsC;IACtC,cAAc,EAAE,UAAU,CAIX;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,iDAAiD;IACjD,KAAK,EAAE,UAAU,CAAgB;QAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;KACpB,CAAC;CACH,CAAC,CAAC"}