@indexnetwork/protocol 14.3.2-rc.477.1 → 17.0.0-rc.479.1

package/dist/networks/application/network.graph.d.ts

@@ -1,4 +1,5 @@
 import type { NetworkGraphDatabase } from "../ports/index.js";
+import { NetworkGraphState } from "../domain/index.js";
 /**
  * Factory class to build and compile the Network (community) lifecycle graph.
  *
@@ -27,13 +28,20 @@ import type { NetworkGraphDatabase } from "../ports/index.js";
  *
  * IND-546: canonical home — previously network/network.graph.ts.
  */
+/** The graph's channel state, as every node sees it. */
+export type NetworkState = typeof NetworkGraphState.State;
+/** Everything the network nodes reach for. */
+export interface NetworkGraphDeps {
+    database: NetworkGraphDatabase;
+}
 export declare class NetworkGraphFactory {
-    private database;
+    /** Resolved dependency bag shared by every node. */
+    readonly deps: NetworkGraphDeps;
     constructor(database: NetworkGraphDatabase);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         userId: string;
         networkId: string | undefined;
-        operationMode: "delete" | "update" | "create" | "read";
+        operationMode: "update" | "create" | "delete" | "read";
         createInput: {
             title: string;
             prompt?: string;
@@ -92,7 +100,7 @@ export declare class NetworkGraphFactory {
     }, {
         userId?: string | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-        operationMode?: "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read"> | undefined;
+        operationMode?: "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read"> | undefined;
         createInput?: {
             title: string;
             prompt?: string;
@@ -204,7 +212,7 @@ export declare class NetworkGraphFactory {
             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<"delete" | "update" | "create" | "read", "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read">, 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;
@@ -365,7 +373,7 @@ export declare class NetworkGraphFactory {
             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<"delete" | "update" | "create" | "read", "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read">, 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;
@@ -637,3 +645,138 @@ export declare class NetworkGraphFactory {
         };
     }, unknown, unknown, []>;
 }
+/**
+ * Read Node: List networks the user belongs to and owns.
+ */
+export declare function readNode(state: NetworkState, deps: NetworkGraphDeps): Promise<{
+    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 Node: Create a new network and add user as owner.
+ *
+ * Atomicity contract:
+ * 1. Create the network row.
+ * 2. Add the calling user as owner.
+ * 3. On step-2 failure: soft-delete the network (rollback).
+ * 4. Rollback failures are logged at error level but never override the
+ *    primary failure message returned to the caller.
+ */
+export declare function createNode(state: NetworkState, deps: NetworkGraphDeps): Promise<{
+    mutationResult: {
+        success: boolean;
+        error: string;
+        networkId?: undefined;
+        title?: undefined;
+        message?: undefined;
+    };
+} | {
+    mutationResult: {
+        success: boolean;
+        networkId: string;
+        title: string;
+        message: string;
+        error?: undefined;
+    };
+}>;
+/**
+ * Update Node: Update network settings (owner only).
+ */
+export declare function updateNode(state: NetworkState, deps: NetworkGraphDeps): Promise<{
+    mutationResult: {
+        success: boolean;
+        error: string;
+        networkId?: undefined;
+        message?: undefined;
+    };
+} | {
+    mutationResult: {
+        success: boolean;
+        networkId: string;
+        message: string;
+        error?: undefined;
+    };
+}>;
+/**
+ * Delete Node: Soft-delete a network (owner only, sole member).
+ */
+export declare function deleteNode(state: NetworkState, deps: NetworkGraphDeps): Promise<{
+    mutationResult: {
+        success: boolean;
+        error: string;
+        networkId?: undefined;
+        message?: undefined;
+    };
+} | {
+    mutationResult: {
+        success: boolean;
+        networkId: string;
+        message: string;
+        error?: undefined;
+    };
+}>;
+export declare function routeByMode(state: NetworkState): string;