@indexnetwork/protocol 19.0.0-rc.482.1 → 20.0.0-rc.484.1

package/dist/networks/network.module.d.ts

@@ -0,0 +1,1314 @@
+/**
+ * networks — the capability's single public surface.
+ *
+ * Everything the rest of the package (and every host) may reach lives on the
+ * {@link Networks} class. The files beside this one are private implementation,
+ * named for what they do rather than for the layer they sit in:
+ *
+ *   network.graph        the community lifecycle graph — create, read, update, delete
+ *   network.state        that graph's channel state
+ *   membership.graph     the roster graph — add, list, remove members
+ *   membership.state     that graph's channel state
+ *   indexer.graph        signal↔community assignment, direct or model-evaluated
+ *   indexer.state        that graph's channel state
+ *   network.recommender  ranking public communities during onboarding
+ *   network.tools        the agent-facing tool definitions
+ *
+ * No directories: every stage here is one or two files, so a folder per stage
+ * would only add a hop. Nothing outside `networks/` imports any of it; the
+ * layout may change freely as long as this class keeps its shape.
+ */
+import type { DefineTool } from "../shared/agent/tool.helpers.js";
+import type { IntentNetworkGraphDatabase, NetworkGraphDatabase, NetworkMembershipGraphDatabase } from "../shared/interfaces/database.interface.js";
+import type { IntentNetworkIndexer } from "./indexer.graph.js";
+import type { NetworkToolDeps } from "./network.tools.js";
+export type { IntentNetworkIndexer, NetworkToolDeps };
+/**
+ * Host capabilities the community graphs need.
+ *
+ * Both fields are optional so a host can construct `new Networks()` and reach
+ * only {@link Networks.createTools}; each `create…Graph` method names the
+ * dependency it requires.
+ */
+export interface NetworksDeps {
+    /**
+     * Community, roster, and assignment persistence. Required by every
+     * `create…Graph` method — hosts pass one adapter satisfying all three
+     * query sets.
+     */
+    database?: NetworkGraphDatabase & NetworkMembershipGraphDatabase & IntentNetworkGraphDatabase;
+    /**
+     * Scores a signal against a community. Required by
+     * {@link Networks.createAssignmentGraph}; an `Intents` instance satisfies it.
+     */
+    indexer?: IntentNetworkIndexer;
+}
+/**
+ * The networks capability.
+ *
+ * One instance is cheap: it holds its dependencies and compiles a graph only
+ * when asked, so a host can keep a single `Networks` and build just the graphs
+ * it serves.
+ */
+export declare class Networks {
+    private readonly deps;
+    constructor(deps?: NetworksDeps);
+    /**
+     * Build the community lifecycle graph — create, read, update, delete.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
+        userId: string;
+        networkId: string | undefined;
+        operationMode: "update" | "create" | "delete" | "read";
+        createInput: {
+            title: string;
+            prompt?: string;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined;
+        updateInput: {
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined;
+        showAll: boolean;
+        readResult: {
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | undefined;
+        mutationResult: {
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | undefined;
+        error: string | null;
+    }, {
+        userId?: string | undefined;
+        networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        operationMode?: "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read"> | undefined;
+        createInput?: {
+            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;
+        updateInput?: {
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | import("@langchain/langgraph").OverwriteValue<{
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined> | undefined;
+        showAll?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
+        readResult?: {
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | import("@langchain/langgraph").OverwriteValue<{
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | undefined> | undefined;
+        mutationResult?: {
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | undefined> | undefined;
+        error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
+    }, "update" | "__start__" | "create" | "read" | "delete_idx", {
+        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>;
+        };
+        networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"update" | "create" | "delete" | "read", "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read">, unknown>;
+        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>;
+        updateInput: import("@langchain/langgraph").BaseChannel<{
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined, {
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | import("@langchain/langgraph").OverwriteValue<{
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined> | undefined, unknown>;
+        showAll: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | undefined, {
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | import("@langchain/langgraph").OverwriteValue<{
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | undefined> | undefined, unknown>;
+        mutationResult: import("@langchain/langgraph").BaseChannel<{
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | undefined, {
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | undefined> | undefined, unknown>;
+        error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+    }, {
+        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>;
+        };
+        networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"update" | "create" | "delete" | "read", "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read">, unknown>;
+        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>;
+        updateInput: import("@langchain/langgraph").BaseChannel<{
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined, {
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | import("@langchain/langgraph").OverwriteValue<{
+            title?: string;
+            prompt?: string | null;
+            imageUrl?: string | null;
+            joinPolicy?: "anyone" | "invite_only";
+        } | undefined> | undefined, unknown>;
+        showAll: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | undefined, {
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | import("@langchain/langgraph").OverwriteValue<{
+            memberOf: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                autoAssign: boolean;
+                isPersonal: boolean;
+                joinedAt: Date;
+            }>;
+            owns: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                intentCount: number;
+                joinPolicy: string;
+            }>;
+            publicNetworks?: Array<{
+                networkId: string;
+                title: string;
+                prompt: string | null;
+                memberCount: number;
+                owner: {
+                    name: string;
+                    avatar: string | null;
+                } | null;
+            }>;
+            stats: {
+                memberOfCount: number;
+                ownsCount: number;
+                publicNetworksCount?: number;
+                scopeNote?: string;
+            };
+        } | undefined> | undefined, unknown>;
+        mutationResult: import("@langchain/langgraph").BaseChannel<{
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | undefined, {
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            success: boolean;
+            networkId?: string;
+            title?: string;
+            message?: string;
+            error?: string;
+        } | undefined> | undefined, unknown>;
+        error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+    }, import("@langchain/langgraph").StateDefinition, {
+        read: {
+            readResult: {
+                memberOf: {
+                    networkId: string;
+                    title: string;
+                    prompt: string | null;
+                    autoAssign: boolean;
+                    isPersonal: boolean;
+                    joinedAt: Date;
+                }[];
+                owns: {
+                    networkId: string;
+                    title: string;
+                    prompt: string | null;
+                    memberCount: number;
+                    intentCount: number;
+                    joinPolicy: "anyone" | "invite_only";
+                }[];
+                stats: {
+                    memberOfCount: number;
+                    ownsCount: number;
+                    scopeNote: string;
+                    publicNetworksCount?: undefined;
+                };
+                publicNetworks?: undefined;
+            };
+            error?: undefined;
+        } | {
+            readResult: {
+                memberOf: {
+                    networkId: string;
+                    title: string;
+                    prompt: string | null;
+                    autoAssign: boolean;
+                    isPersonal: boolean;
+                    joinedAt: Date;
+                }[];
+                owns: {
+                    networkId: string;
+                    title: string;
+                    prompt: string | null;
+                    memberCount: number;
+                    intentCount: number;
+                    joinPolicy: "anyone" | "invite_only";
+                }[];
+                publicNetworks: {
+                    networkId: string;
+                    title: string;
+                    prompt: string | null;
+                    memberCount: number;
+                    owner: {
+                        id: string;
+                        name: string;
+                        avatar: string | null;
+                    } | null;
+                }[];
+                stats: {
+                    memberOfCount: number;
+                    ownsCount: number;
+                    publicNetworksCount: number;
+                    scopeNote?: undefined;
+                };
+            };
+            error?: undefined;
+        } | {
+            error: string;
+            readResult?: undefined;
+        };
+        create: {
+            mutationResult: {
+                success: boolean;
+                error: string;
+                networkId?: undefined;
+                title?: undefined;
+                message?: undefined;
+            };
+        } | {
+            mutationResult: {
+                success: boolean;
+                networkId: string;
+                title: string;
+                message: string;
+                error?: undefined;
+            };
+        };
+        update: {
+            mutationResult: {
+                success: boolean;
+                error: string;
+                networkId?: undefined;
+                message?: undefined;
+            };
+        } | {
+            mutationResult: {
+                success: boolean;
+                networkId: string;
+                message: string;
+                error?: undefined;
+            };
+        };
+        delete_idx: {
+            mutationResult: {
+                success: boolean;
+                error: string;
+                networkId?: undefined;
+                message?: undefined;
+            };
+        } | {
+            mutationResult: {
+                success: boolean;
+                networkId: string;
+                message: string;
+                error?: undefined;
+            };
+        };
+    }, unknown, unknown, []>;
+    /**
+     * Build the membership graph — add, list, and remove members, under the
+     * community's join policy and owner authority.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createMembershipGraph(): import("@langchain/langgraph").CompiledStateGraph<{
+        userId: string;
+        networkId: string;
+        operationMode: "create" | "delete" | "read";
+        targetUserId: string | undefined;
+        readResult: {
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined;
+        mutationResult: {
+            success: boolean;
+            message?: string;
+            error?: string;
+        } | undefined;
+        error: string | null;
+    }, {
+        userId?: string | undefined;
+        networkId?: string | undefined;
+        operationMode?: "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read"> | undefined;
+        targetUserId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        readResult?: {
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined> | undefined;
+        mutationResult?: {
+            success: boolean;
+            message?: string;
+            error?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            success: boolean;
+            message?: string;
+            error?: string;
+        } | undefined> | undefined;
+        error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
+    }, "__start__" | "add_member" | "list_members" | "remove_member", {
+        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>;
+        };
+        networkId: {
+            (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>;
+        };
+        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+        targetUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined, {
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined> | undefined, unknown>;
+        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: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+    }, {
+        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>;
+        };
+        networkId: {
+            (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>;
+        };
+        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+        targetUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined, {
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            networkId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined> | undefined, unknown>;
+        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: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+    }, import("@langchain/langgraph").StateDefinition, {
+        add_member: {
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+        } | {
+            mutationResult: {
+                success: boolean;
+                message: string;
+                error?: undefined;
+            };
+        };
+        list_members: {
+            readResult: {
+                networkId: string;
+                count: number;
+                members: never[];
+            };
+            error: string;
+        } | {
+            readResult: {
+                networkId: string;
+                count: number;
+                members: {
+                    userId: string;
+                    name: string;
+                    avatar: string | null;
+                    permissions: string[];
+                    intentCount: number;
+                    joinedAt: Date;
+                }[];
+            };
+            error?: undefined;
+        } | {
+            error: string;
+            readResult?: undefined;
+        };
+        remove_member: {
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+        } | {
+            mutationResult: {
+                success: boolean;
+                message: string;
+                error?: undefined;
+            };
+        };
+    }, unknown, unknown, []>;
+    /**
+     * Build the signal↔community assignment graph — link a signal to a community
+     * directly or after model evaluation, and unlink it.
+     *
+     * @throws If the instance was constructed without a `database` or an `indexer`.
+     */
+    createAssignmentGraph(): import("@langchain/langgraph").CompiledStateGraph<{
+        userId: string;
+        networkId: string | undefined;
+        intentId: string | undefined;
+        operationMode: "create" | "delete" | "read";
+        skipEvaluation: boolean;
+        intent: import("./indexer.state.js").IntentForIndexing | null;
+        indexContext: import("./indexer.state.js").IndexMemberContext | null;
+        evaluation: {
+            reasoning: string;
+            indexScore: number;
+            memberScore: number;
+        } | null;
+        shouldAssign: boolean | undefined;
+        finalScore: number | undefined;
+        assignmentResult: import("./indexer.state.js").AssignmentResult | null;
+        queryUserId: string | undefined;
+        readResult: {
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | undefined;
+        mutationResult: {
+            success: boolean;
+            message?: string;
+            error?: string;
+        } | undefined;
+        error: string | null;
+        agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+    }, {
+        userId?: string | undefined;
+        networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        intentId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        operationMode?: "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read"> | undefined;
+        skipEvaluation?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
+        intent?: import("./indexer.state.js").IntentForIndexing | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IntentForIndexing | null> | null | undefined;
+        indexContext?: import("./indexer.state.js").IndexMemberContext | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IndexMemberContext | null> | null | undefined;
+        evaluation?: {
+            reasoning: string;
+            indexScore: number;
+            memberScore: number;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            reasoning: string;
+            indexScore: number;
+            memberScore: number;
+        } | null> | null | undefined;
+        shouldAssign?: boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined;
+        finalScore?: number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined;
+        assignmentResult?: import("./indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").AssignmentResult | null> | null | undefined;
+        queryUserId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        readResult?: {
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | undefined> | undefined;
+        mutationResult?: {
+            success: boolean;
+            message?: string;
+            error?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            success: boolean;
+            message?: string;
+            error?: string;
+        } | undefined> | undefined;
+        error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
+        agentTimings?: import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]> | undefined;
+    }, "__start__" | "read" | "assign" | "unassign", {
+        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>;
+        };
+        networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        intentId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+        skipEvaluation: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        intent: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IntentForIndexing | null, import("./indexer.state.js").IntentForIndexing | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IntentForIndexing | null> | null, unknown>;
+        indexContext: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IndexMemberContext | null, import("./indexer.state.js").IndexMemberContext | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IndexMemberContext | null> | null, unknown>;
+        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>;
+        shouldAssign: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
+        finalScore: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+        assignmentResult: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").AssignmentResult | null, import("./indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").AssignmentResult | null> | null, unknown>;
+        queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | undefined, {
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | undefined> | undefined, unknown>;
+        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: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+        agentTimings: import("@langchain/langgraph").BaseChannel<import("../chat/chat-streaming.types.js").DebugMetaAgent[], import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]>, unknown>;
+    }, {
+        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>;
+        };
+        networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        intentId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+        skipEvaluation: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        intent: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IntentForIndexing | null, import("./indexer.state.js").IntentForIndexing | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IntentForIndexing | null> | null, unknown>;
+        indexContext: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IndexMemberContext | null, import("./indexer.state.js").IndexMemberContext | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IndexMemberContext | null> | null, unknown>;
+        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>;
+        shouldAssign: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
+        finalScore: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
+        assignmentResult: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").AssignmentResult | null, import("./indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").AssignmentResult | null> | null, unknown>;
+        queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | undefined, {
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            links: Array<{
+                intentId: string;
+                networkId: string;
+                intentTitle?: string;
+                networkTitle?: string;
+                userId?: string;
+                userName?: string;
+                createdAt?: Date;
+                relevancyScore?: number | null;
+            }>;
+            count: number;
+            mode: string;
+            note?: string;
+        } | undefined> | undefined, unknown>;
+        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: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+        agentTimings: import("@langchain/langgraph").BaseChannel<import("../chat/chat-streaming.types.js").DebugMetaAgent[], import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]>, unknown>;
+    }, import("@langchain/langgraph").StateDefinition, {
+        assign: {
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+            evaluation?: undefined;
+            shouldAssign?: undefined;
+            finalScore?: undefined;
+        } | {
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            mutationResult: {
+                success: boolean;
+                message: string;
+                error?: undefined;
+            };
+            evaluation?: undefined;
+            shouldAssign?: undefined;
+            finalScore?: undefined;
+        } | {
+            assignmentResult: import("./indexer.state.js").AssignmentResult;
+            mutationResult: {
+                success: boolean;
+                message: string;
+                error?: undefined;
+            };
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            evaluation?: undefined;
+            shouldAssign?: undefined;
+            finalScore?: undefined;
+        } | {
+            assignmentResult: import("./indexer.state.js").AssignmentResult;
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            evaluation?: undefined;
+            shouldAssign?: undefined;
+            finalScore?: undefined;
+        } | {
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            evaluation: null;
+            shouldAssign: boolean;
+            finalScore: number;
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+        } | {
+            assignmentResult: import("./indexer.state.js").AssignmentResult;
+            mutationResult: {
+                success: boolean;
+                message: string;
+                error?: undefined;
+            };
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            evaluation: {
+                reasoning: string;
+                indexScore: number;
+                memberScore: number;
+            };
+            shouldAssign: boolean;
+            finalScore: number;
+        } | {
+            assignmentResult: import("./indexer.state.js").AssignmentResult;
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            evaluation: {
+                reasoning: string;
+                indexScore: number;
+                memberScore: number;
+            };
+            shouldAssign: boolean;
+            finalScore: number;
+        };
+        read: {
+            readResult: {
+                links: never[];
+                count: number;
+                mode: string;
+                note?: undefined;
+            };
+            error: string;
+        } | {
+            readResult: {
+                links: {
+                    intentId: string;
+                    networkId: string;
+                }[];
+                count: number;
+                mode: string;
+                note: string;
+            };
+            error?: undefined;
+        } | {
+            error: string;
+            readResult?: undefined;
+        };
+        unassign: {
+            mutationResult: {
+                success: boolean;
+                error: string;
+                message?: undefined;
+            };
+        } | {
+            mutationResult: {
+                success: boolean;
+                message: string;
+                error?: undefined;
+            };
+        };
+    }, unknown, unknown, []>;
+    /** Register the agent-facing community tools against a tool definer. */
+    static createTools(defineTool: DefineTool, deps: NetworkToolDeps): readonly [any, any, any, any, any, any, any];
+    /** The database, or the error naming the method that needed it. */
+    private database;
+}