@indexnetwork/protocol 0.1.0

package/dist/mcp/mcp.server.js

@@ -0,0 +1,171 @@
+/**
+ * MCP Server Factory — creates an McpServer instance with all protocol tools
+ * registered from the existing tool registry. Each tool invocation resolves
+ * auth from the HTTP request, builds a ResolvedToolContext, and delegates
+ * to the raw tool handler.
+ */
+import { z } from 'zod';
+import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server';
+import { resolveChatContext } from '../tools/tool.helpers.js';
+import { createToolRegistry } from '../tools/tool.registry.js';
+import { protocolLogger } from '../support/protocol.logger.js';
+const logger = protocolLogger('McpServer');
+// ═══════════════════════════════════════════════════════════════════════════════
+// ZOD 3 → JSON SCHEMA CONVERSION
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Minimal Zod-to-JSON-Schema conversion for MCP tool registration.
+ * Converts Zod 3.x schemas to plain JSON Schema objects that can be
+ * wrapped with `fromJsonSchema()` for MCP SDK compatibility.
+ */
+function zodToJsonSchema(schema) {
+    if (schema instanceof z.ZodObject) {
+        const shape = schema.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            const zodValue = value;
+            properties[key] = zodToJsonSchema(zodValue);
+            if (!(zodValue instanceof z.ZodOptional) && !(zodValue instanceof z.ZodDefault)) {
+                required.push(key);
+            }
+        }
+        return { type: 'object', properties, ...(required.length ? { required } : {}) };
+    }
+    if (schema instanceof z.ZodString) {
+        const result = { type: 'string' };
+        // Detect .url(), .email(), .uuid() etc. via Zod's internal checks array
+        const checks = schema._def?.checks;
+        if (checks) {
+            for (const check of checks) {
+                if (check.kind === 'url')
+                    result.format = 'uri';
+                else if (check.kind === 'email')
+                    result.format = 'email';
+                else if (check.kind === 'uuid')
+                    result.format = 'uuid';
+                else if (check.kind === 'datetime')
+                    result.format = 'date-time';
+            }
+        }
+        return result;
+    }
+    if (schema instanceof z.ZodNumber) {
+        const checks = schema._def?.checks;
+        const result = { type: 'number' };
+        if (checks) {
+            for (const check of checks) {
+                if (check.kind === 'int')
+                    result.type = 'integer';
+                else if (check.kind === 'min')
+                    result.minimum = check.value;
+                else if (check.kind === 'max')
+                    result.maximum = check.value;
+            }
+        }
+        return result;
+    }
+    if (schema instanceof z.ZodBoolean)
+        return { type: 'boolean' };
+    if (schema instanceof z.ZodArray) {
+        return { type: 'array', items: zodToJsonSchema(schema.element) };
+    }
+    if (schema instanceof z.ZodOptional) {
+        return zodToJsonSchema(schema.unwrap());
+    }
+    if (schema instanceof z.ZodDefault) {
+        return zodToJsonSchema(schema.removeDefault());
+    }
+    if (schema instanceof z.ZodEnum) {
+        return { type: 'string', enum: schema.options };
+    }
+    if (schema instanceof z.ZodNullable) {
+        const inner = zodToJsonSchema(schema.unwrap());
+        return { ...inner, nullable: true };
+    }
+    if (schema instanceof z.ZodRecord) {
+        return { type: 'object', additionalProperties: true };
+    }
+    return { type: 'object' };
+}
+/**
+ * Creates an MCP server with all protocol tools registered.
+ * Tools resolve auth per-request via the HTTP request available in ServerContext.
+ *
+ * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)
+ * @param authResolver - Resolves authenticated user ID from the HTTP request
+ * @param scopedDepsFactory - Factory for creating per-request scoped databases
+ * @returns A configured McpServer ready to be connected to a transport
+ */
+export function createMcpServer(deps, authResolver, scopedDepsFactory) {
+    const server = new McpServer({
+        name: 'index-network',
+        version: '1.0.0',
+    });
+    const registry = createToolRegistry(deps);
+    for (const [toolName, toolDef] of registry) {
+        // Convert Zod 3 schema to JSON Schema, then wrap with fromJsonSchema
+        // for MCP SDK's StandardSchemaWithJSON compatibility
+        const jsonSchema = zodToJsonSchema(toolDef.schema);
+        const mcpSchema = fromJsonSchema(jsonSchema);
+        server.registerTool(toolName, {
+            description: toolDef.description,
+            inputSchema: mcpSchema,
+        }, async (args, ctx) => {
+            try {
+                // Extract the original HTTP request from the MCP server context
+                const httpReq = ctx.http?.req;
+                if (!httpReq) {
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ error: 'No HTTP request available in MCP context' }) }],
+                        isError: true,
+                    };
+                }
+                // Resolve authenticated user
+                const userId = await authResolver.resolveUserId(httpReq);
+                // Resolve chat context for the user
+                const context = await resolveChatContext({ database: deps.database, userId });
+                // Build per-request scoped databases via injected factory
+                const indexScope = context.userIndexes.map((m) => m.indexId);
+                const scopedDbs = scopedDepsFactory.create(userId, indexScope);
+                // Override deps with per-request scoped databases
+                const requestDeps = { ...deps, ...scopedDbs };
+                // Re-create registry with per-request deps for scoped database access
+                const requestRegistry = createToolRegistry(requestDeps);
+                const requestTool = requestRegistry.get(toolName);
+                if (!requestTool) {
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ error: `Tool "${toolName}" not found` }) }],
+                        isError: true,
+                    };
+                }
+                // Validate input against the original Zod schema
+                const parseResult = toolDef.schema.safeParse(args);
+                if (!parseResult.success) {
+                    const issues = parseResult.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ success: false, error: `Invalid input: ${issues}` }) }],
+                        isError: true,
+                    };
+                }
+                const validatedArgs = parseResult.data;
+                // Execute the tool handler
+                const result = await requestTool.handler({ context, query: validatedArgs });
+                return {
+                    content: [{ type: 'text', text: result }],
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.error(`MCP tool "${toolName}" failed`, { error: message });
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    logger.verbose(`MCP server created with ${registry.size} tools`);
+    return server;
+}
+//# sourceMappingURL=mcp.server.js.map

package/dist/mcp/mcp.server.js.map

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

package/dist/states/chat.state.d.ts

@@ -0,0 +1,126 @@
+import type { BaseMessage } from "@langchain/core/messages";
+import type { DebugMetaToolCall } from "../types/chat-streaming.types.js";
+/** Routing decision from router node (target, operationType, extractedContext). */
+export interface RoutingDecision {
+    target: string;
+    operationType: string | null;
+    extractedContext?: string | null;
+}
+/** Intent subgraph result (actions, inferredIntents, etc.). */
+export interface IntentSubgraphResult {
+    actions?: Array<{
+        type: string;
+        payload?: string;
+    }>;
+    inferredIntents?: unknown[];
+    indexingResults?: unknown[];
+    mode?: string;
+    intents?: unknown[];
+    count?: number;
+    error?: string;
+    /** When the intent graph exits early (e.g. index-scoped without intents); surface to user. */
+    requiredMessage?: string;
+}
+/** Index subgraph result (memberships, ownedIndexes, specificIndexData). */
+export interface IndexSubgraphResult {
+    mode?: string;
+    memberships?: unknown[];
+    ownedIndexes?: unknown[];
+    specificIndexData?: unknown;
+    count?: number;
+    error?: string;
+}
+/** Aggregated results from subgraphs (intent, index, profile, opportunity, scrape). */
+export interface SubgraphResults {
+    intent?: IntentSubgraphResult;
+    index?: IndexSubgraphResult;
+    profile?: unknown;
+    opportunity?: unknown;
+    scrape?: unknown;
+}
+/**
+ * The Chat Graph State using LangGraph Annotations.
+ *
+ * This is a simplified state for the agent loop architecture.
+ * The agent handles all routing decisions internally via tool calling.
+ *
+ * Design Principles:
+ * - Messages accumulate through the conversation (includes tool calls/results)
+ * - Iteration count tracks loop progress for soft/hard limits
+ * - Final response is extracted at the end
+ */
+export declare const ChatGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /**
+     * The User ID - required for all operations.
+     */
+    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>;
+    };
+    /**
+     * Optional index (community) ID when chat is scoped to a specific index.
+     * When set, the agent and tools use this as the current index (e.g. read_intents,
+     * create_intent with indexId, scope index assignment to this index only).
+     */
+    indexId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Chat session ID when streaming with context. Used by tools to create draft
+     * opportunities tied to this conversation (context.conversationId).
+     */
+    sessionId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Conversation history using LangGraph's built-in message reducer.
+     * Includes: HumanMessage, AIMessage, ToolMessage, SystemMessage
+     * Automatically handles message appending, ID management, and ordering.
+     */
+    messages: import("@langchain/langgraph").BaseChannel<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[], BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[]>, unknown>;
+    /**
+     * Current iteration count in the agent loop.
+     * Used for soft limit (nudge) and hard limit (force exit).
+     */
+    iterationCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    /**
+     * Flag indicating whether the agent loop should continue.
+     * Set to false when agent produces final response or hits hard limit.
+     */
+    shouldContinue: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /**
+     * The final generated response text.
+     * Set when the agent decides to stop and respond.
+     */
+    responseText: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Error message if the agent loop fails.
+     */
+    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Per-turn debug meta (graph, iterations, tool calls) for copy-debug.
+     * Not persisted; only used so the streamer receives it in the updates chunk.
+     */
+    debugMeta: import("@langchain/langgraph").BaseChannel<{
+        graph: string;
+        iterations: number;
+        tools: DebugMetaToolCall[];
+    } | undefined, {
+        graph: string;
+        iterations: number;
+        tools: DebugMetaToolCall[];
+    } | import("@langchain/langgraph").OverwriteValue<{
+        graph: string;
+        iterations: number;
+        tools: DebugMetaToolCall[];
+    } | undefined> | undefined, unknown>;
+    /** Router output: target, operationType, extractedContext. */
+    routingDecision: import("@langchain/langgraph").BaseChannel<RoutingDecision | undefined, RoutingDecision | import("@langchain/langgraph").OverwriteValue<RoutingDecision | undefined> | undefined, unknown>;
+    /** Results from intent/profile/opportunity/scrape subgraphs. */
+    subgraphResults: import("@langchain/langgraph").BaseChannel<SubgraphResults | undefined, SubgraphResults | import("@langchain/langgraph").OverwriteValue<SubgraphResults | undefined> | undefined, unknown>;
+    /** User profile context (e.g. for intent nodes). */
+    userProfile: import("@langchain/langgraph").BaseChannel<unknown, unknown, unknown>;
+}>;
+/**
+ * The full state type for the Chat Graph.
+ * Use this for typing node functions and graph invocations.
+ */
+export type ChatGraphStateType = typeof ChatGraphState.State;
+//# sourceMappingURL=chat.state.d.ts.map

package/dist/states/chat.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.state.d.ts","sourceRoot":"","sources":["../../src/states/chat.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAM1E,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc;IAKzB;;OAEG;;;;;;IAGH;;;;OAIG;;IAMH;;;OAGG;;IAMH;;;;OAIG;;IAUH;;;OAGG;;IAMH;;;OAGG;;IAUH;;;OAGG;;IAMH;;OAEG;;IAMH;;;OAGG;;eAC4B,MAAM;oBAAc,MAAM;eAAS,iBAAiB,EAAE;;eAAtD,MAAM;oBAAc,MAAM;eAAS,iBAAiB,EAAE;;eAAtD,MAAM;oBAAc,MAAM;eAAS,iBAAiB,EAAE;;IAMrF,8DAA8D;;IAK9D,gEAAgE;;IAKhE,oDAAoD;;EAMpD,CAAC;AAMH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,cAAc,CAAC,KAAK,CAAC"}

package/dist/states/chat.state.js

@@ -0,0 +1,112 @@
+import { Annotation, messagesStateReducer } from "@langchain/langgraph";
+// ══════════════════════════════════════════════════════════════════════════════
+// CHAT GRAPH STATE (Agent Loop Architecture)
+// ══════════════════════════════════════════════════════════════════════════════
+/**
+ * The Chat Graph State using LangGraph Annotations.
+ *
+ * This is a simplified state for the agent loop architecture.
+ * The agent handles all routing decisions internally via tool calling.
+ *
+ * Design Principles:
+ * - Messages accumulate through the conversation (includes tool calls/results)
+ * - Iteration count tracks loop progress for soft/hard limits
+ * - Final response is extracted at the end
+ */
+export const ChatGraphState = Annotation.Root({
+    // ═══════════════════════════════════════════════════════════════════════════
+    // CORE INPUTS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * The User ID - required for all operations.
+     */
+    userId: (Annotation),
+    /**
+     * Optional index (community) ID when chat is scoped to a specific index.
+     * When set, the agent and tools use this as the current index (e.g. read_intents,
+     * create_intent with indexId, scope index assignment to this index only).
+     */
+    indexId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Chat session ID when streaming with context. Used by tools to create draft
+     * opportunities tied to this conversation (context.conversationId).
+     */
+    sessionId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Conversation history using LangGraph's built-in message reducer.
+     * Includes: HumanMessage, AIMessage, ToolMessage, SystemMessage
+     * Automatically handles message appending, ID management, and ordering.
+     */
+    messages: Annotation({
+        reducer: messagesStateReducer,
+        default: () => [],
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // LOOP CONTROL
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Current iteration count in the agent loop.
+     * Used for soft limit (nudge) and hard limit (force exit).
+     */
+    iterationCount: Annotation({
+        reducer: (curr, next) => next,
+        default: () => 0,
+    }),
+    /**
+     * Flag indicating whether the agent loop should continue.
+     * Set to false when agent produces final response or hits hard limit.
+     */
+    shouldContinue: Annotation({
+        reducer: (curr, next) => next,
+        default: () => true,
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // OUTPUTS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * The final generated response text.
+     * Set when the agent decides to stop and respond.
+     */
+    responseText: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * Error message if the agent loop fails.
+     */
+    error: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * Per-turn debug meta (graph, iterations, tool calls) for copy-debug.
+     * Not persisted; only used so the streamer receives it in the updates chunk.
+     */
+    debugMeta: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    // Legacy subgraph state (used by index/intent/response nodes when present)
+    /** Router output: target, operationType, extractedContext. */
+    routingDecision: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /** Results from intent/profile/opportunity/scrape subgraphs. */
+    subgraphResults: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /** User profile context (e.g. for intent nodes). */
+    userProfile: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+});
+//# sourceMappingURL=chat.state.js.map

package/dist/states/chat.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.state.js","sourceRoot":"","sources":["../../src/states/chat.state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAgDxE,iFAAiF;AACjF,6CAA6C;AAC7C,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAC5C,8EAA8E;IAC9E,cAAc;IACd,8EAA8E;IAE9E;;OAEG;IACH,MAAM,EAAE,CAAA,UAAkB,CAAA;IAE1B;;;;OAIG;IACH,OAAO,EAAE,UAAU,CAAqB;QACtC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF;;;OAGG;IACH,SAAS,EAAE,UAAU,CAAqB;QACxC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF;;;;OAIG;IACH,QAAQ,EAAE,UAAU,CAAgB;QAClC,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;IAEF,8EAA8E;IAC9E,eAAe;IACf,8EAA8E;IAE9E;;;OAGG;IACH,cAAc,EAAE,UAAU,CAAS;QACjC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;KACjB,CAAC;IAEF;;;OAGG;IACH,cAAc,EAAE,UAAU,CAAU;QAClC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;KACpB,CAAC;IAEF,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;;OAGG;IACH,YAAY,EAAE,UAAU,CAAqB;QAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF;;OAEG;IACH,KAAK,EAAE,UAAU,CAAqB;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF;;;OAGG;IACH,SAAS,EAAE,UAAU,CAAgF;QACnG,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,2EAA2E;IAC3E,8DAA8D;IAC9D,eAAe,EAAE,UAAU,CAA8B;QACvD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IACF,gEAAgE;IAChE,eAAe,EAAE,UAAU,CAA8B;QACvD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IACF,oDAAoD;IACpD,WAAW,EAAE,UAAU,CAAU;QAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;CAEH,CAAC,CAAC"}

package/dist/states/home.state.d.ts

@@ -0,0 +1,100 @@
+import type { Opportunity } from '../interfaces/database.interface.js';
+import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+/**
+ * Home view card item: one opportunity with full presenter-driven display contract.
+ */
+export interface HomeCardItem {
+    opportunityId: string;
+    userId: string;
+    name: string;
+    avatar: string | null;
+    mainText: string;
+    cta: string;
+    headline?: string;
+    /** Presenter-generated; primary button (accept) and secondary button (dismiss). */
+    primaryActionLabel: string;
+    secondaryActionLabel: string;
+    /** Presenter-generated subtitle under the other party name (e.g. "1 mutual intent"). */
+    mutualIntentsLabel: string;
+    /** Narrator chip for human-introduced opportunities; avatar set when narrator is a user */
+    narratorChip?: {
+        name: string;
+        text: string;
+        avatar?: string | null;
+        userId?: string;
+    };
+    /** Viewer's role in this opportunity (e.g. 'introducer', 'party', 'agent', 'patient', 'peer'). */
+    viewerRole?: string;
+    /** Whether the counterpart is a ghost (not yet onboarded) user. */
+    isGhost?: boolean;
+    /** Second party in introducer arrow layout. Present when viewerRole is 'introducer'. */
+    secondParty?: {
+        name: string;
+        avatar?: string | null;
+        userId?: string;
+    };
+    /** For section assignment from LLM */
+    _cardIndex: number;
+}
+/**
+ * Dynamic section from LLM categorization.
+ */
+export interface HomeSectionProposal {
+    id: string;
+    title: string;
+    subtitle?: string;
+    iconName: string;
+    itemIndices: number[];
+}
+/** Card item as returned in API (no internal _cardIndex). */
+export type HomeSectionItem = Omit<HomeCardItem, '_cardIndex'>;
+/**
+ * Final section for API response.
+ */
+export interface HomeSection {
+    id: string;
+    title: string;
+    subtitle?: string;
+    iconName: string;
+    items: HomeSectionItem[];
+}
+/**
+ * Home Graph State (Annotation-based).
+ * Flow: loadOpportunities → generateCardText → categorizeDynamically → normalizeAndSort → finalizeResponse.
+ */
+export declare const HomeGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    userId: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+    indexId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    limit: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    /** When true, bypass presenter and categorizer Redis caches. */
+    noCache: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Raw opportunities visible to the viewer (after visibility filter). */
+    opportunities: import("@langchain/langgraph").BaseChannel<Opportunity[], Opportunity[] | import("@langchain/langgraph").OverwriteValue<Opportunity[]>, unknown>;
+    /** Cards with presenter output and narrator chip. */
+    cards: import("@langchain/langgraph").BaseChannel<HomeCardItem[], HomeCardItem[] | import("@langchain/langgraph").OverwriteValue<HomeCardItem[]>, unknown>;
+    /** LLM output: dynamic sections with icon and item indices. */
+    sectionProposals: import("@langchain/langgraph").BaseChannel<HomeSectionProposal[], HomeSectionProposal[] | import("@langchain/langgraph").OverwriteValue<HomeSectionProposal[]>, unknown>;
+    /** Final sections for response. */
+    sections: import("@langchain/langgraph").BaseChannel<HomeSection[], HomeSection[] | import("@langchain/langgraph").OverwriteValue<HomeSection[]>, unknown>;
+    /** Presenter results retrieved from cache (opportunityId → HomeCardItem). */
+    cachedCards: import("@langchain/langgraph").BaseChannel<Map<string, HomeCardItem>, Map<string, HomeCardItem> | import("@langchain/langgraph").OverwriteValue<Map<string, HomeCardItem>>, unknown>;
+    /** Opportunities that had no cache hit and need presenter generation. */
+    uncachedOpportunities: import("@langchain/langgraph").BaseChannel<Opportunity[], Opportunity[] | import("@langchain/langgraph").OverwriteValue<Opportunity[]>, unknown>;
+    /** Whether categorizer results were found in cache. */
+    categoryCacheHit: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Meta for response (e.g. totalOpportunities, totalSections). */
+    meta: import("@langchain/langgraph").BaseChannel<{
+        totalOpportunities: number;
+        totalSections: number;
+    }, {
+        totalOpportunities: number;
+        totalSections: number;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        totalOpportunities: number;
+        totalSections: number;
+    }>, unknown>;
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
+}>;
+//# sourceMappingURL=home.state.d.ts.map

package/dist/states/home.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.state.d.ts","sourceRoot":"","sources":["../../src/states/home.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wFAAwF;IACxF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2FAA2F;IAC3F,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wFAAwF;IACxF,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;IAczB,gEAAgE;;IAMhE,yEAAyE;;IAMzE,qDAAqD;;IAMrD,+DAA+D;;IAM/D,mCAAmC;;IAMnC,6EAA6E;;IAM7E,yEAAyE;;IAMzE,uDAAuD;;;IAWvD,kEAAkE;;4BAC3B,MAAM;uBAAiB,MAAM;;4BAA7B,MAAM;uBAAiB,MAAM;;4BAA7B,MAAM;uBAAiB,MAAM;;IAKpE,sEAAsE;;EAKtE,CAAC"}

package/dist/states/home.state.js

@@ -0,0 +1,74 @@
+import { Annotation } from '@langchain/langgraph';
+/**
+ * Home Graph State (Annotation-based).
+ * Flow: loadOpportunities → generateCardText → categorizeDynamically → normalizeAndSort → finalizeResponse.
+ */
+export const HomeGraphState = Annotation.Root({
+    userId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => '',
+    }),
+    indexId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    limit: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 50,
+    }),
+    /** When true, bypass presenter and categorizer Redis caches. */
+    noCache: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    /** Raw opportunities visible to the viewer (after visibility filter). */
+    opportunities: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    /** Cards with presenter output and narrator chip. */
+    cards: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    /** LLM output: dynamic sections with icon and item indices. */
+    sectionProposals: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    /** Final sections for response. */
+    sections: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    /** Presenter results retrieved from cache (opportunityId → HomeCardItem). */
+    cachedCards: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => new Map(),
+    }),
+    /** Opportunities that had no cache hit and need presenter generation. */
+    uncachedOpportunities: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    /** Whether categorizer results were found in cache. */
+    categoryCacheHit: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    error: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Meta for response (e.g. totalOpportunities, totalSections). */
+    meta: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => ({ totalOpportunities: 0, totalSections: 0 }),
+    }),
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: Annotation({
+        reducer: (acc, val) => [...acc, ...val],
+        default: () => [],
+    }),
+});
+//# sourceMappingURL=home.state.js.map

package/dist/states/home.state.js.map

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