@indexnetwork/protocol 0.1.0 → 0.2.0

package/dist/graphs/network.graph.js

@@ -0,0 +1,226 @@
+import { StateGraph, START, END } from "@langchain/langgraph";
+import { protocolLogger } from "../support/protocol.logger.js";
+import { timed } from "../support/performance.js";
+import { NetworkGraphState } from "../states/network.state.js";
+const logger = protocolLogger("NetworkGraphFactory");
+/**
+ * Factory class to build and compile the Index (CRUD) Graph.
+ *
+ * Handles create, read, update, and delete operations for indexes.
+ * Membership and intent-index assignment operations are handled by
+ * separate graphs (NetworkMembershipGraph and IntentNetworkGraph).
+ *
+ * Flow:
+ * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
+ */
+export class NetworkGraphFactory {
+    constructor(database) {
+        this.database = database;
+    }
+    createGraph() {
+        // --- NODE DEFINITIONS ---
+        /**
+         * Read Node: List indexes the user belongs to and owns.
+         */
+        const readNode = async (state) => {
+            return timed("NetworkGraph.read", async () => {
+                logger.verbose("Read indexes", { userId: state.userId, networkId: state.networkId, showAll: state.showAll });
+                try {
+                    const [allMemberships, ownedIndexes, publicIndexesResult] = await Promise.all([
+                        this.database.getNetworkMemberships(state.userId),
+                        this.database.getOwnedIndexes(state.userId),
+                        this.database.getPublicIndexesNotJoined(state.userId),
+                    ]);
+                    // If index-scoped and not showAll, return just that index (no public indexes in scoped view)
+                    const scopeToCurrentIndex = state.networkId && !state.showAll;
+                    if (scopeToCurrentIndex) {
+                        const networkId = state.networkId;
+                        const isMember = await this.database.isNetworkMember(networkId, state.userId);
+                        if (!isMember) {
+                            return {
+                                readResult: {
+                                    memberOf: [],
+                                    owns: [],
+                                    stats: { memberOfCount: 0, ownsCount: 0, scopeNote: "Network not found or you are not a member." },
+                                },
+                            };
+                        }
+                        const membership = allMemberships.find((m) => m.networkId === networkId);
+                        const owned = ownedIndexes.find((o) => o.id === networkId);
+                        return {
+                            readResult: {
+                                memberOf: membership
+                                    ? [{ networkId: membership.networkId, title: membership.networkTitle, description: membership.indexPrompt, autoAssign: membership.autoAssign, joinedAt: membership.joinedAt }]
+                                    : [],
+                                owns: owned
+                                    ? [{ networkId: owned.id, title: owned.title, description: owned.prompt, memberCount: owned.memberCount, intentCount: owned.intentCount, joinPolicy: owned.permissions.joinPolicy }]
+                                    : [],
+                                stats: { memberOfCount: membership ? 1 : 0, ownsCount: owned ? 1 : 0, scopeNote: "Showing current index. Use showAll: true for all indexes." },
+                            },
+                        };
+                    }
+                    // Include public indexes available to join
+                    const publicIndexes = publicIndexesResult.networks.map((idx) => ({
+                        networkId: idx.id,
+                        title: idx.title,
+                        description: idx.prompt,
+                        memberCount: idx.memberCount,
+                        owner: idx.owner,
+                    }));
+                    return {
+                        readResult: {
+                            memberOf: allMemberships.map((m) => ({ networkId: m.networkId, title: m.networkTitle, description: m.indexPrompt, autoAssign: m.autoAssign, joinedAt: m.joinedAt })),
+                            owns: ownedIndexes.map((o) => ({ networkId: o.id, title: o.title, description: o.prompt, memberCount: o.memberCount, intentCount: o.intentCount, joinPolicy: o.permissions.joinPolicy })),
+                            publicIndexes,
+                            stats: { memberOfCount: allMemberships.length, ownsCount: ownedIndexes.length, publicIndexesCount: publicIndexes.length },
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Read indexes failed", { error: err });
+                    return { error: "Failed to fetch network information." };
+                }
+            });
+        };
+        /**
+         * Create Node: Create a new index and add user as owner.
+         */
+        const createNode = async (state) => {
+            return timed("NetworkGraph.create", async () => {
+                logger.verbose("Create index", { userId: state.userId, createInput: state.createInput });
+                if (!state.createInput?.title?.trim()) {
+                    return { mutationResult: { success: false, error: "Title is required." } };
+                }
+                let createdIndexId;
+                try {
+                    const index = await this.database.createNetwork({
+                        title: state.createInput.title.trim(),
+                        prompt: state.createInput.prompt?.trim() || undefined,
+                        imageUrl: state.createInput.imageUrl ?? undefined,
+                        joinPolicy: state.createInput.joinPolicy,
+                    });
+                    createdIndexId = index.id;
+                    const added = await this.database.addMemberToIndex(index.id, state.userId, 'owner');
+                    if (!added.success) {
+                        logger.error("addMemberToIndex failed; cleaning up orphaned index", { networkId: index.id });
+                        try {
+                            await this.database.softDeleteIndex(index.id);
+                        }
+                        catch { }
+                        return { mutationResult: { success: false, error: "Failed to set you as owner. Network was not created." } };
+                    }
+                    return {
+                        mutationResult: {
+                            success: true,
+                            networkId: index.id,
+                            title: index.title,
+                            message: `Network "${index.title}" created. You are the owner.`,
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Create index failed", { error: err });
+                    if (createdIndexId) {
+                        try {
+                            await this.database.softDeleteIndex(createdIndexId);
+                        }
+                        catch { }
+                    }
+                    return { mutationResult: { success: false, error: "Failed to create network." } };
+                }
+            });
+        };
+        /**
+         * Update Node: Update index settings (owner only).
+         */
+        const updateNode = async (state) => {
+            return timed("NetworkGraph.update", async () => {
+                const networkId = state.networkId;
+                logger.verbose("Update index", { userId: state.userId, networkId, updateInput: state.updateInput });
+                if (!networkId) {
+                    return { mutationResult: { success: false, error: "networkId is required for update." } };
+                }
+                try {
+                    const isOwner = await this.database.isIndexOwner(networkId, state.userId);
+                    if (!isOwner) {
+                        return { mutationResult: { success: false, error: "You can only modify networks you own." } };
+                    }
+                    await this.database.updateIndexSettings(networkId, state.userId, state.updateInput ?? {});
+                    return {
+                        mutationResult: {
+                            success: true,
+                            networkId,
+                            message: "Network settings updated.",
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Update index failed", { error: err });
+                    return { mutationResult: { success: false, error: "Failed to update network." } };
+                }
+            });
+        };
+        /**
+         * Delete Node: Soft-delete an index (owner only, sole member).
+         */
+        const deleteNode = async (state) => {
+            return timed("NetworkGraph.delete", async () => {
+                const networkId = state.networkId;
+                logger.verbose("Delete index", { userId: state.userId, networkId });
+                if (!networkId) {
+                    return { mutationResult: { success: false, error: "networkId is required for delete." } };
+                }
+                try {
+                    const isOwner = await this.database.isIndexOwner(networkId, state.userId);
+                    if (!isOwner) {
+                        return { mutationResult: { success: false, error: "You can only delete networks you own." } };
+                    }
+                    const count = await this.database.getIndexMemberCount(networkId);
+                    if (count > 1) {
+                        return { mutationResult: { success: false, error: "Cannot delete network with other members. Remove members first." } };
+                    }
+                    await this.database.softDeleteIndex(networkId);
+                    return {
+                        mutationResult: {
+                            success: true,
+                            networkId,
+                            message: "Network deleted.",
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Delete index failed", { error: err });
+                    return { mutationResult: { success: false, error: "Failed to delete network." } };
+                }
+            });
+        };
+        // --- CONDITIONAL ROUTING ---
+        const routeByMode = (state) => {
+            switch (state.operationMode) {
+                case 'create': return 'create';
+                case 'read': return 'read';
+                case 'update': return 'update';
+                case 'delete': return 'delete_idx';
+                default: return 'read';
+            }
+        };
+        // --- GRAPH ASSEMBLY ---
+        const workflow = new StateGraph(NetworkGraphState)
+            .addNode("read", readNode)
+            .addNode("create", createNode)
+            .addNode("update", updateNode)
+            .addNode("delete_idx", deleteNode)
+            .addConditionalEdges(START, routeByMode, {
+            read: "read",
+            create: "create",
+            update: "update",
+            delete_idx: "delete_idx",
+        })
+            .addEdge("read", END)
+            .addEdge("create", END)
+            .addEdge("update", END)
+            .addEdge("delete_idx", END);
+        return workflow.compile();
+    }
+}
+//# sourceMappingURL=network.graph.js.map

package/dist/graphs/network.graph.js.map

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

package/dist/graphs/network_membership.graph.d.ts

@@ -0,0 +1,250 @@
+import type { NetworkMembershipGraphDatabase } from "../interfaces/database.interface.js";
+/**
+ * Factory class to build and compile the Index 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)
+ */
+export declare class NetworkMembershipGraphFactory {
+    private database;
+    constructor(database: NetworkMembershipGraphDatabase);
+    createGraph(): 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>;
+}
+//# sourceMappingURL=network_membership.graph.d.ts.map

package/dist/graphs/network_membership.graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network_membership.graph.d.ts","sourceRoot":"","sources":["../../src/graphs/network_membership.graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAO1F;;;;;;;GAOG;AACH,qBAAa,6BAA6B;IAC5B,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,8BAA8B;IAErD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgNnB"}