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

package/dist/communities/domain/membership.state.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Network Membership Graph State.
+ * Handles CRUD operations for network memberships (index_members table).
+ *
+ * ## Membership authority policy
+ *
+ * - `create` / self-join: allowed only when `joinPolicy: 'anyone'`.
+ * - `create` / invite (targetUserId ≠ userId): caller must be a member;
+ *   for `invite_only` networks, caller must also be the owner.
+ * - `delete`: owner-only; the owner themselves cannot be removed via this path
+ *   (delete the network instead).
+ * - `read`: caller must be a member of the network to list its members.
+ *
+ * Flow:
+ * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
+ *
+ * IND-546: canonical home — previously network/membership/membership.state.ts.
+ */
+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 network. 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>;
+}>;

package/dist/communities/domain/membership.state.js

@@ -0,0 +1,53 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * Network Membership Graph State.
+ * Handles CRUD operations for network memberships (index_members table).
+ *
+ * ## Membership authority policy
+ *
+ * - `create` / self-join: allowed only when `joinPolicy: 'anyone'`.
+ * - `create` / invite (targetUserId ≠ userId): caller must be a member;
+ *   for `invite_only` networks, caller must also be the owner.
+ * - `delete`: owner-only; the owner themselves cannot be removed via this path
+ *   (delete the network instead).
+ * - `read`: caller must be a member of the network to list its members.
+ *
+ * Flow:
+ * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
+ *
+ * IND-546: canonical home — previously network/membership/membership.state.ts.
+ */
+export const NetworkMembershipGraphState = Annotation.Root({
+    // --- Core Inputs (from ChatGraph via ToolContext) ---
+    /** User performing the action (the actor). Always required. */
+    userId: (Annotation),
+    /** Target network. 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,
+    }),
+});

package/dist/communities/domain/network.state.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Network Graph State.
+ * Handles CRUD operations for networks (communities).
+ *
+ * Lifecycle flow:
+ * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
+ *
+ * ## Scope semantics
+ *
+ * When the chat is network-scoped (`networkId` is set) and `showAll` is false,
+ * readNode surfaces only the focused network plus the user's personal network
+ * (contacts).  Setting `showAll: true` bypasses the restriction (admin use).
+ *
+ * IND-546: canonical home — previously network/network.state.ts.
+ */
+export declare const NetworkGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /** User performing the action. 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 network ID. Required for read/update/delete. From ChatGraph or tool arg. */
+    networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Operation mode. */
+    operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "update" | "create" | "read", "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read">, unknown>;
+    /** For create mode: network creation data. */
+    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>;
+    /** For update mode: fields to update. */
+    updateInput: import("@langchain/langgraph").BaseChannel<{
+        title?: string;
+        prompt?: string | null;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+        allowGuestVibeCheck?: boolean;
+    } | undefined, {
+        title?: string;
+        prompt?: string | null;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+        allowGuestVibeCheck?: boolean;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        title?: string;
+        prompt?: string | null;
+        imageUrl?: string | null;
+        joinPolicy?: "anyone" | "invite_only";
+        allowGuestVibeCheck?: boolean;
+    } | undefined> | undefined, unknown>;
+    /**
+     * When true and network-scoped, read returns all user networks (not just scoped one).
+     * Default false to enforce strict scope isolation.
+     */
+    showAll: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Output for read mode. */
+    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>;
+    /** Output for create/update/delete modes. */
+    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 message if graph could not complete. */
+    error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, unknown>;
+}>;

package/dist/communities/domain/network.state.js

@@ -0,0 +1,66 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * Network Graph State.
+ * Handles CRUD operations for networks (communities).
+ *
+ * Lifecycle flow:
+ * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
+ *
+ * ## Scope semantics
+ *
+ * When the chat is network-scoped (`networkId` is set) and `showAll` is false,
+ * readNode surfaces only the focused network plus the user's personal network
+ * (contacts).  Setting `showAll: true` bypasses the restriction (admin use).
+ *
+ * IND-546: canonical home — previously network/network.state.ts.
+ */
+export const NetworkGraphState = Annotation.Root({
+    // --- Core Inputs (from ChatGraph via ToolContext) ---
+    /** User performing the action. Always required. */
+    userId: (Annotation),
+    /** Target network ID. Required for read/update/delete. From ChatGraph or tool arg. */
+    networkId: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Operation mode. */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'read',
+    }),
+    // --- Mode-Specific Inputs ---
+    /** For create mode: network creation data. */
+    createInput: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** For update mode: fields to update. */
+    updateInput: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * When true and network-scoped, read returns all user networks (not just scoped one).
+     * Default false to enforce strict scope isolation.
+     */
+    showAll: Annotation({
+        reducer: (_, next) => next,
+        default: () => false,
+    }),
+    // --- Outputs ---
+    /** Output for read mode. */
+    readResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Output for create/update/delete modes. */
+    mutationResult: Annotation({
+        reducer: (_, next) => next,
+        default: () => undefined,
+    }),
+    /** Error message if graph could not complete. */
+    error: Annotation({
+        reducer: (_, next) => next,
+        default: () => null,
+    }),
+});

package/dist/communities/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * communities — domain-first module root.
+ *
+ * Re-exports the curated public surface.  Other modules inside the communities
+ * capability import directly from communities/domain, communities/application,
+ * or communities/ports; this barrel is for cross-capability consumers that must
+ * go through the communities public surface.
+ *
+ * IND-546: canonical home for network lifecycle, membership, scope, and signal
+ * assignment behaviour previously spread across network/, network/membership/,
+ * and network/indexer/.  Legacy network/* paths remain as compatibility
+ * re-exports pointing here.
+ */
+export * from "./public/index.js";

package/dist/communities/index.js

@@ -0,0 +1,14 @@
+/**
+ * communities — domain-first module root.
+ *
+ * Re-exports the curated public surface.  Other modules inside the communities
+ * capability import directly from communities/domain, communities/application,
+ * or communities/ports; this barrel is for cross-capability consumers that must
+ * go through the communities public surface.
+ *
+ * IND-546: canonical home for network lifecycle, membership, scope, and signal
+ * assignment behaviour previously spread across network/, network/membership/,
+ * and network/indexer/.  Legacy network/* paths remain as compatibility
+ * re-exports pointing here.
+ */
+export * from "./public/index.js";

package/dist/communities/ports/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * communities/ports — narrow injected dependency contracts.
+ *
+ * Re-exports the subset of types that the communities capability declares as
+ * explicit injected ports.  Consumers of the communities module should import
+ * these types from here rather than from the broader shared/interfaces barrel
+ * to keep the dependency surface narrow and auditable.
+ *
+ * ## Port groups
+ *
+ * ### Persistence ports
+ * - NetworkGraphDatabase — network lifecycle CRUD (membership + owner queries).
+ * - NetworkMembershipGraphDatabase — cross-user membership operations.
+ * - IntentNetworkGraphDatabase — intent–network link CRUD + context queries.
+ *
+ * ### Signal-assignment port
+ * - IntentIndexer, IntentIndexerOutput — LLM evaluator interface injected into
+ *   IntentNetworkGraphFactory.  Sourced from capabilities/signals.facade.ts (the
+ *   signals public facade) so that communities never imports signals internals.
+ *
+ * IND-546: explicit port layer for communities; signals consumed via capabilities/signals.facade.ts.
+ */
+export type { NetworkGraphDatabase, NetworkMembershipGraphDatabase, IntentNetworkGraphDatabase, } from "../../shared/interfaces/database.interface.js";
+export { IntentIndexer } from "../../capabilities/signals.facade.js";
+export type { IntentIndexerOutput } from "../../capabilities/signals.facade.js";

package/dist/communities/ports/index.js

@@ -0,0 +1,27 @@
+/**
+ * communities/ports — narrow injected dependency contracts.
+ *
+ * Re-exports the subset of types that the communities capability declares as
+ * explicit injected ports.  Consumers of the communities module should import
+ * these types from here rather than from the broader shared/interfaces barrel
+ * to keep the dependency surface narrow and auditable.
+ *
+ * ## Port groups
+ *
+ * ### Persistence ports
+ * - NetworkGraphDatabase — network lifecycle CRUD (membership + owner queries).
+ * - NetworkMembershipGraphDatabase — cross-user membership operations.
+ * - IntentNetworkGraphDatabase — intent–network link CRUD + context queries.
+ *
+ * ### Signal-assignment port
+ * - IntentIndexer, IntentIndexerOutput — LLM evaluator interface injected into
+ *   IntentNetworkGraphFactory.  Sourced from capabilities/signals.facade.ts (the
+ *   signals public facade) so that communities never imports signals internals.
+ *
+ * IND-546: explicit port layer for communities; signals consumed via capabilities/signals.facade.ts.
+ */
+// ── Signal-assignment port ────────────────────────────────────────────────────
+// Re-exported from the signals capability facade so that application-layer code
+// (indexer.graph.ts, indexer.state.ts) imports from the communities port, not
+// directly from the signals facade or its implementation.
+export { IntentIndexer } from "../../capabilities/signals.facade.js";

package/dist/communities/public/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * communities/public — curated public surface of the communities capability.
+ *
+ * Re-exports the stable contracts from domain, application, and ports.
+ * Runtime adapter creation (graph factories, tool factories) is accessible
+ * via capabilities/communities.facade.ts for package consumers and via the
+ * foreground shell (runtime/foreground) for internal registries.
+ *
+ * Boundary: public-compatibility.  References only communities/domain,
+ * communities/application, and communities/ports — never runtime/foreground
+ * or host implementations.
+ *
+ * ## Intentionally excluded from public surface
+ *
+ * The following are application-internal:
+ * - IntentNetworkGraphState, IntentForIndexing, IndexMemberContext,
+ *   AssignmentResult — indexer graph execution state types; import from
+ *   communities/application/ when genuinely needed.
+ * - NetworkRecommender — LLM ranking agent used only inside createNetworkTools;
+ *   import from communities/application/ if required for testing overrides.
+ *
+ * IND-546: canonical public surface for communities capability.
+ * Legacy paths (capabilities/communities.facade.ts) re-export from here.
+ */
+export { NetworkGraphState, NetworkMembershipGraphState, } from "../domain/index.js";
+export { NetworkGraphFactory } from "../application/index.js";
+export { NetworkMembershipGraphFactory } from "../application/index.js";
+export { IntentNetworkGraphFactory } from "../application/index.js";
+export { createNetworkTools } from "../application/index.js";
+export type { NetworkGraphDatabase, NetworkMembershipGraphDatabase, IntentNetworkGraphDatabase, } from "../ports/index.js";

package/dist/communities/public/index.js

@@ -0,0 +1,33 @@
+/**
+ * communities/public — curated public surface of the communities capability.
+ *
+ * Re-exports the stable contracts from domain, application, and ports.
+ * Runtime adapter creation (graph factories, tool factories) is accessible
+ * via capabilities/communities.facade.ts for package consumers and via the
+ * foreground shell (runtime/foreground) for internal registries.
+ *
+ * Boundary: public-compatibility.  References only communities/domain,
+ * communities/application, and communities/ports — never runtime/foreground
+ * or host implementations.
+ *
+ * ## Intentionally excluded from public surface
+ *
+ * The following are application-internal:
+ * - IntentNetworkGraphState, IntentForIndexing, IndexMemberContext,
+ *   AssignmentResult — indexer graph execution state types; import from
+ *   communities/application/ when genuinely needed.
+ * - NetworkRecommender — LLM ranking agent used only inside createNetworkTools;
+ *   import from communities/application/ if required for testing overrides.
+ *
+ * IND-546: canonical public surface for communities capability.
+ * Legacy paths (capabilities/communities.facade.ts) re-export from here.
+ */
+// ── Domain contracts ──────────────────────────────────────────────────────────
+export { NetworkGraphState, NetworkMembershipGraphState, } from "../domain/index.js";
+// ── Application seams ─────────────────────────────────────────────────────────
+// Graph factories (foreground + ambient adapter entry points)
+export { NetworkGraphFactory } from "../application/index.js";
+export { NetworkMembershipGraphFactory } from "../application/index.js";
+export { IntentNetworkGraphFactory } from "../application/index.js";
+// Tool factory (foreground adapter composition entry point)
+export { createNetworkTools } from "../application/index.js";

package/dist/contact/contact.inviter.d.ts

@@ -1,47 +1,10 @@
 /**
- * Invite Generator Agent
+ * @deprecated Canonical location: contacts/application/contact.inviter
+ * Retained for backward compatibility during IND-549 migration.
+ * Import generateInviteMessage from contacts/application or via
+ * capabilities/contacts.facade.ts instead.
  *
- * Generates contextual, editable invite messages for ghost users.
- * Produces warm, concise messages (~3-5 sentences) referencing why two
- * users were matched, with optional referrer mention.
+ * IND-549: migrated to src/contacts/application/contact.inviter.ts.
  */
-import { z } from "zod";
-declare const InviteInputSchema: z.ZodObject<{
-    recipientName: z.ZodString;
-    senderName: z.ZodString;
-    opportunityInterpretation: z.ZodString;
-    senderIntents: z.ZodArray<z.ZodString, "many">;
-    recipientIntents: z.ZodArray<z.ZodString, "many">;
-    referrerName: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    recipientName: string;
-    senderName: string;
-    opportunityInterpretation: string;
-    senderIntents: string[];
-    recipientIntents: string[];
-    referrerName?: string | undefined;
-}, {
-    recipientName: string;
-    senderName: string;
-    opportunityInterpretation: string;
-    senderIntents: string[];
-    recipientIntents: string[];
-    referrerName?: string | undefined;
-}>;
-declare const InviteOutputSchema: z.ZodObject<{
-    message: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-}, {
-    message: string;
-}>;
-export type InviteInput = z.infer<typeof InviteInputSchema>;
-export type InviteOutput = z.infer<typeof InviteOutputSchema>;
-/**
- * Generates a contextual invite message for a ghost user.
- * @param input - Context about sender, recipient, and opportunity
- * @returns Generated invite message text
- */
-export declare function generateInviteMessage(input: InviteInput): Promise<InviteOutput>;
-export {};
-//# sourceMappingURL=contact.inviter.d.ts.map
+export { generateInviteMessage } from "../contacts/application/index.js";
+export type { InviteInput, InviteOutput } from "../contacts/application/index.js";