@indexnetwork/protocol 6.12.1-rc.404.1 → 6.14.0-rc.406.1

package/dist/network/membership/membership.graph.d.ts

@@ -1,250 +1,5 @@
-import type { NetworkMembershipGraphDatabase } from "../../shared/interfaces/database.interface.js";
 /**
- * Factory class to build and compile the Network Membership Graph.
- *
- * Handles CRUD operations for the index_members table:
- * - create: Add a member to an index (validates join policy and ownership)
- * - read: List members of an index (validates caller is member)
- * - delete: Remove a member from an index (future, validates ownership)
+ * @deprecated Canonical location: communities/application/membership.graph — retained
+ * for backward compatibility (IND-546).
  */
-export declare class NetworkMembershipGraphFactory {
-    private database;
-    constructor(database: NetworkMembershipGraphDatabase);
-    createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
-        userId: string;
-        networkId: string;
-        operationMode: "delete" | "create" | "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?: "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "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<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "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<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "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, []>;
-}
-//# sourceMappingURL=membership.graph.d.ts.map
+export { NetworkMembershipGraphFactory } from "../../communities/application/index.js";

package/dist/network/membership/membership.graph.js

@@ -1,204 +1,5 @@
-import { StateGraph, START, END } from "@langchain/langgraph";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { timed } from "../../shared/observability/performance.js";
-import { NetworkMembershipGraphState } from "./membership.state.js";
-const logger = protocolLogger("NetworkMembershipGraphFactory");
 /**
- * Factory class to build and compile the Network Membership Graph.
- *
- * Handles CRUD operations for the index_members table:
- * - create: Add a member to an index (validates join policy and ownership)
- * - read: List members of an index (validates caller is member)
- * - delete: Remove a member from an index (future, validates ownership)
+ * @deprecated Canonical location: communities/application/membership.graph — retained
+ * for backward compatibility (IND-546).
  */
-export class NetworkMembershipGraphFactory {
-    constructor(database) {
-        this.database = database;
-    }
-    createGraph() {
-        // --- NODE DEFINITIONS ---
-        /**
-         * Add Member Node: Add a user as a member of an index.
-         * Handles two cases:
-         * 1. Self-join (targetUserId === userId): Only allowed for public networks (joinPolicy 'anyone')
-         * 2. Invite others (targetUserId !== userId): Requires caller to be member; owner-only for invite_only
-         */
-        const addMemberNode = async (state) => {
-            return timed("NetworkMembershipGraph.addMember", async () => {
-                logger.verbose("Add member to index", {
-                    userId: state.userId,
-                    networkId: state.networkId,
-                    targetUserId: state.targetUserId,
-                });
-                if (!state.targetUserId) {
-                    return { mutationResult: { success: false, error: "targetUserId is required." } };
-                }
-                try {
-                    const indexRecord = await this.database.getNetworkWithPermissions(state.networkId);
-                    if (!indexRecord) {
-                        return { mutationResult: { success: false, error: "Index not found." } };
-                    }
-                    const joinPolicy = indexRecord.permissions.joinPolicy;
-                    const isSelfJoin = state.targetUserId === state.userId;
-                    if (isSelfJoin) {
-                        // Self-join: only allowed for public networks
-                        if (joinPolicy !== 'anyone') {
-                            return {
-                                mutationResult: {
-                                    success: false,
-                                    error: "This network is invite-only. You cannot join without an invitation from an existing member.",
-                                },
-                            };
-                        }
-                        const result = await this.database.addMemberToNetwork(state.networkId, state.targetUserId, 'member');
-                        if (result.alreadyMember) {
-                            return { mutationResult: { success: true, message: "You are already a member of this network." } };
-                        }
-                        return { mutationResult: { success: true, message: `You have joined "${indexRecord.title}".` } };
-                    }
-                    // Inviting others: must be a member first
-                    const isMember = await this.database.isNetworkMember(state.networkId, state.userId);
-                    if (!isMember) {
-                        return { mutationResult: { success: false, error: "You must be a member of that network to add others." } };
-                    }
-                    if (joinPolicy === 'invite_only') {
-                        const isOwner = await this.database.isIndexOwner(state.networkId, state.userId);
-                        if (!isOwner) {
-                            return { mutationResult: { success: false, error: "Only the network owner can add members when the network is invite-only." } };
-                        }
-                    }
-                    const result = await this.database.addMemberToNetwork(state.networkId, state.targetUserId, 'member');
-                    if (result.alreadyMember) {
-                        return { mutationResult: { success: true, message: "That user is already a member of this network." } };
-                    }
-                    return { mutationResult: { success: true, message: "Member added to the network." } };
-                }
-                catch (err) {
-                    logger.error("Add member failed", { error: err });
-                    return {
-                        mutationResult: {
-                            success: false,
-                            error: err instanceof Error ? err.message : "Failed to add member.",
-                        },
-                    };
-                }
-            });
-        };
-        /**
-         * List Members Node: List all members of a network.
-         * Validates caller is a member.
-         */
-        const listMembersNode = async (state) => {
-            return timed("NetworkMembershipGraph.listMembers", async () => {
-                logger.verbose("List network members", {
-                    userId: state.userId,
-                    networkId: state.networkId,
-                });
-                try {
-                    const isMember = await this.database.isNetworkMember(state.networkId, state.userId);
-                    if (!isMember) {
-                        return {
-                            readResult: {
-                                networkId: state.networkId,
-                                count: 0,
-                                members: [],
-                            },
-                            error: "Network not found or you are not a member.",
-                        };
-                    }
-                    const members = await this.database.getNetworkMembersForMember(state.networkId, state.userId);
-                    return {
-                        readResult: {
-                            networkId: state.networkId,
-                            count: members.length,
-                            members: members.map((m) => ({
-                                userId: m.userId,
-                                name: m.name,
-                                avatar: m.avatar,
-                                permissions: m.permissions,
-                                intentCount: m.intentCount,
-                                joinedAt: m.joinedAt,
-                            })),
-                        },
-                    };
-                }
-                catch (err) {
-                    logger.error("List members failed", { error: err });
-                    if (err instanceof Error && err.message === "Access denied: Not a member of this network") {
-                        return { error: "You must be a member of that network." };
-                    }
-                    return { error: "Failed to fetch network members." };
-                }
-            });
-        };
-        /**
-         * Remove Member Node: Remove a member from a network (owner only).
-         */
-        const removeMemberNode = async (state) => {
-            return timed("NetworkMembershipGraph.removeMember", async () => {
-                logger.verbose("Remove member from network", {
-                    userId: state.userId,
-                    networkId: state.networkId,
-                    targetUserId: state.targetUserId,
-                });
-                if (!state.targetUserId) {
-                    return { mutationResult: { success: false, error: "targetUserId is required." } };
-                }
-                // Cannot remove yourself via this flow
-                if (state.targetUserId === state.userId) {
-                    return { mutationResult: { success: false, error: "You cannot remove yourself. Use 'leave network' instead." } };
-                }
-                try {
-                    const isOwner = await this.database.isIndexOwner(state.networkId, state.userId);
-                    if (!isOwner) {
-                        return { mutationResult: { success: false, error: "Only the network owner can remove members." } };
-                    }
-                    const result = await this.database.removeMemberFromIndex(state.networkId, state.targetUserId);
-                    if (result.wasOwner) {
-                        return { mutationResult: { success: false, error: "Cannot remove the network owner." } };
-                    }
-                    if (result.notMember) {
-                        return { mutationResult: { success: false, error: "User is not a member of this network." } };
-                    }
-                    if (!result.success) {
-                        return { mutationResult: { success: false, error: "Failed to remove member." } };
-                    }
-                    return {
-                        mutationResult: {
-                            success: true,
-                            message: "Member removed from the index.",
-                        },
-                    };
-                }
-                catch (err) {
-                    logger.error("Remove member failed", { error: err });
-                    return { mutationResult: { success: false, error: "Failed to remove member." } };
-                }
-            });
-        };
-        // --- CONDITIONAL ROUTING ---
-        const routeByMode = (state) => {
-            switch (state.operationMode) {
-                case 'create': return 'add_member';
-                case 'read': return 'list_members';
-                case 'delete': return 'remove_member';
-                default: return 'list_members';
-            }
-        };
-        // --- GRAPH ASSEMBLY ---
-        const workflow = new StateGraph(NetworkMembershipGraphState)
-            .addNode("add_member", addMemberNode)
-            .addNode("list_members", listMembersNode)
-            .addNode("remove_member", removeMemberNode)
-            .addConditionalEdges(START, routeByMode, {
-            add_member: "add_member",
-            list_members: "list_members",
-            remove_member: "remove_member",
-        })
-            .addEdge("add_member", END)
-            .addEdge("list_members", END)
-            .addEdge("remove_member", END);
-        return workflow.compile();
-    }
-}
-//# sourceMappingURL=membership.graph.js.map
+export { NetworkMembershipGraphFactory } from "../../communities/application/index.js";

package/dist/network/membership/membership.state.d.ts

@@ -1,77 +1,5 @@
 /**
- * Network Membership Graph State.
- * Handles CRUD operations for network memberships (index_members table).
- *
- * Flow:
- * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
+ * @deprecated Canonical location: communities/domain/membership.state — retained
+ * for backward compatibility (IND-546).
  */
-export declare const NetworkMembershipGraphState: 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. */
-    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>;
-    };
-    /** Operation mode. */
-    operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "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<{
-        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>;
-    /** 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=membership.state.d.ts.map
+export { NetworkMembershipGraphState } from "../../communities/domain/index.js";

package/dist/network/membership/membership.state.js

@@ -1,43 +1,5 @@
-import { Annotation } from "@langchain/langgraph";
 /**
- * Network Membership Graph State.
- * Handles CRUD operations for network memberships (index_members table).
- *
- * Flow:
- * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
+ * @deprecated Canonical location: communities/domain/membership.state — retained
+ * for backward compatibility (IND-546).
  */
-export const NetworkMembershipGraphState = Annotation.Root({
-    // --- Core Inputs (from ChatGraph via ToolContext) ---
-    /** User performing the action (the actor). Always required. */
-    userId: (Annotation),
-    /** Target index. Required for all operations. */
-    networkId: (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=membership.state.js.map
+export { NetworkMembershipGraphState } from "../../communities/domain/index.js";