@indexnetwork/protocol 0.1.0

package/dist/graphs/index.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 { IndexGraphState } from "../states/index.state.js";
+const logger = protocolLogger("IndexGraphFactory");
+/**
+ * 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 (IndexMembershipGraph and IntentIndexGraph).
+ *
+ * Flow:
+ * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
+ */
+export class IndexGraphFactory {
+    constructor(database) {
+        this.database = database;
+    }
+    createGraph() {
+        // --- NODE DEFINITIONS ---
+        /**
+         * Read Node: List indexes the user belongs to and owns.
+         */
+        const readNode = async (state) => {
+            return timed("IndexGraph.read", async () => {
+                logger.verbose("Read indexes", { userId: state.userId, indexId: state.indexId, showAll: state.showAll });
+                try {
+                    const [allMemberships, ownedIndexes, publicIndexesResult] = await Promise.all([
+                        this.database.getIndexMemberships(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.indexId && !state.showAll;
+                    if (scopeToCurrentIndex) {
+                        const indexId = state.indexId;
+                        const isMember = await this.database.isIndexMember(indexId, state.userId);
+                        if (!isMember) {
+                            return {
+                                readResult: {
+                                    memberOf: [],
+                                    owns: [],
+                                    stats: { memberOfCount: 0, ownsCount: 0, scopeNote: "Index not found or you are not a member." },
+                                },
+                            };
+                        }
+                        const membership = allMemberships.find((m) => m.indexId === indexId);
+                        const owned = ownedIndexes.find((o) => o.id === indexId);
+                        return {
+                            readResult: {
+                                memberOf: membership
+                                    ? [{ indexId: membership.indexId, title: membership.indexTitle, description: membership.indexPrompt, autoAssign: membership.autoAssign, joinedAt: membership.joinedAt }]
+                                    : [],
+                                owns: owned
+                                    ? [{ indexId: 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.indexes.map((idx) => ({
+                        indexId: idx.id,
+                        title: idx.title,
+                        description: idx.prompt,
+                        memberCount: idx.memberCount,
+                        owner: idx.owner,
+                    }));
+                    return {
+                        readResult: {
+                            memberOf: allMemberships.map((m) => ({ indexId: m.indexId, title: m.indexTitle, description: m.indexPrompt, autoAssign: m.autoAssign, joinedAt: m.joinedAt })),
+                            owns: ownedIndexes.map((o) => ({ indexId: 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 index information." };
+                }
+            });
+        };
+        /**
+         * Create Node: Create a new index and add user as owner.
+         */
+        const createNode = async (state) => {
+            return timed("IndexGraph.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.createIndex({
+                        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", { indexId: index.id });
+                        try {
+                            await this.database.softDeleteIndex(index.id);
+                        }
+                        catch { }
+                        return { mutationResult: { success: false, error: "Failed to set you as owner. Index was not created." } };
+                    }
+                    return {
+                        mutationResult: {
+                            success: true,
+                            indexId: index.id,
+                            title: index.title,
+                            message: `Index "${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 index." } };
+                }
+            });
+        };
+        /**
+         * Update Node: Update index settings (owner only).
+         */
+        const updateNode = async (state) => {
+            return timed("IndexGraph.update", async () => {
+                const indexId = state.indexId;
+                logger.verbose("Update index", { userId: state.userId, indexId, updateInput: state.updateInput });
+                if (!indexId) {
+                    return { mutationResult: { success: false, error: "indexId is required for update." } };
+                }
+                try {
+                    const isOwner = await this.database.isIndexOwner(indexId, state.userId);
+                    if (!isOwner) {
+                        return { mutationResult: { success: false, error: "You can only modify indexes you own." } };
+                    }
+                    await this.database.updateIndexSettings(indexId, state.userId, state.updateInput ?? {});
+                    return {
+                        mutationResult: {
+                            success: true,
+                            indexId,
+                            message: "Index settings updated.",
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Update index failed", { error: err });
+                    return { mutationResult: { success: false, error: "Failed to update index." } };
+                }
+            });
+        };
+        /**
+         * Delete Node: Soft-delete an index (owner only, sole member).
+         */
+        const deleteNode = async (state) => {
+            return timed("IndexGraph.delete", async () => {
+                const indexId = state.indexId;
+                logger.verbose("Delete index", { userId: state.userId, indexId });
+                if (!indexId) {
+                    return { mutationResult: { success: false, error: "indexId is required for delete." } };
+                }
+                try {
+                    const isOwner = await this.database.isIndexOwner(indexId, state.userId);
+                    if (!isOwner) {
+                        return { mutationResult: { success: false, error: "You can only delete indexes you own." } };
+                    }
+                    const count = await this.database.getIndexMemberCount(indexId);
+                    if (count > 1) {
+                        return { mutationResult: { success: false, error: "Cannot delete index with other members. Remove members first." } };
+                    }
+                    await this.database.softDeleteIndex(indexId);
+                    return {
+                        mutationResult: {
+                            success: true,
+                            indexId,
+                            message: "Index deleted.",
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Delete index failed", { error: err });
+                    return { mutationResult: { success: false, error: "Failed to delete index." } };
+                }
+            });
+        };
+        // --- 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(IndexGraphState)
+            .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=index.graph.js.map

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

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

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

@@ -0,0 +1,250 @@
+import type { IndexMembershipGraphDatabase } 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 IndexMembershipGraphFactory {
+    private database;
+    constructor(database: IndexMembershipGraphDatabase);
+    createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
+        userId: string;
+        indexId: string;
+        operationMode: "create" | "delete" | "read";
+        targetUserId: string | undefined;
+        readResult: {
+            indexId: 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;
+        indexId?: string | undefined;
+        operationMode?: "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read"> | undefined;
+        targetUserId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        readResult?: {
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined> | undefined;
+        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>;
+        };
+        indexId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+            (): import("@langchain/langgraph").LastValue<string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        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<{
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined, {
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined> | undefined, unknown>;
+        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>;
+        };
+        indexId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+            (): import("@langchain/langgraph").LastValue<string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        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<{
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined, {
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            indexId: string;
+            count: number;
+            members: Array<{
+                userId: string;
+                name: string;
+                avatar: string | null;
+                permissions: string[];
+                intentCount: number;
+                joinedAt: Date;
+            }>;
+        } | undefined> | undefined, unknown>;
+        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: {
+                indexId: string;
+                count: number;
+                members: never[];
+            };
+            error: string;
+        } | {
+            readResult: {
+                indexId: 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=index_membership.graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index_membership.graph.d.ts","sourceRoot":"","sources":["../../src/graphs/index_membership.graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAOxF;;;;;;;GAOG;AACH,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,4BAA4B;IAEnD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgNnB"}