@indexnetwork/protocol 0.1.0

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

@@ -0,0 +1,172 @@
+import { ProfileDocument } from "../agents/profile.generator.js";
+import type { DebugMetaAgent } from '../types/chat-streaming.types.js';
+/**
+ * The Graph State for Profile Generation.
+ */
+export declare const ProfileGraphState: import("@langchain/langgraph").AnnotationRoot<{
+    /**
+     * The User ID to link the profile to.
+     */
+    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>;
+    };
+    /**
+     * Operation mode controls graph flow:
+     * - 'query': Fast path - only retrieve existing profile (no generation)
+     * - 'write': Full pipeline - generate/update profile and hyde as needed
+     * - 'generate': Auto-generate profile from user table data via enrichUserProfile Chat API
+     */
+    operationMode: import("@langchain/langgraph").BaseChannel<"query" | "write" | "generate", "query" | "write" | "generate" | import("@langchain/langgraph").OverwriteValue<"query" | "write" | "generate">, unknown>;
+    /**
+     * Flag to force profile regeneration even if profile exists.
+     * When true with new input, the graph will re-generate and update the profile.
+     */
+    forceUpdate: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /**
+     * Pre-populated profile from external enrichment (e.g. Parallel Chat API).
+     * When provided, the graph skips profile generation and only runs embedding + HyDE.
+     */
+    prePopulatedProfile: import("@langchain/langgraph").BaseChannel<{
+        identity: {
+            name: string;
+            bio: string;
+            location: string;
+        };
+        narrative: {
+            context: string;
+        };
+        attributes: {
+            skills: string[];
+            interests: string[];
+        };
+    } | undefined, {
+        identity: {
+            name: string;
+            bio: string;
+            location: string;
+        };
+        narrative: {
+            context: string;
+        };
+        attributes: {
+            skills: string[];
+            interests: string[];
+        };
+    } | import("@langchain/langgraph").OverwriteValue<{
+        identity: {
+            name: string;
+            bio: string;
+            location: string;
+        };
+        narrative: {
+            context: string;
+        };
+        attributes: {
+            skills: string[];
+            interests: string[];
+        };
+    } | undefined> | undefined, unknown>;
+    /**
+     * Internal objective constructed from user data.
+     */
+    objective: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Raw input data (either provided or scraped).
+     */
+    input: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * The generated or loaded profile document.
+     * Includes embedding from DB. Profile HyDE is stored in hyde_documents.
+     */
+    profile: import("@langchain/langgraph").BaseChannel<ProfileDocument | undefined, ProfileDocument | import("@langchain/langgraph").OverwriteValue<ProfileDocument | undefined> | undefined, unknown>;
+    /**
+     * Flags to track what needs to be generated.
+     */
+    needsProfileGeneration: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    needsProfileEmbedding: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    needsHydeGeneration: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    needsHydeEmbedding: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /**
+     * Flag indicating that user information is insufficient for accurate profile generation.
+     * When true, the graph should request additional information from the user.
+     */
+    needsUserInfo: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /**
+     * List of missing user information fields.
+     * Used to construct a helpful clarification message.
+     */
+    missingUserInfo: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+    /**
+     * The generated HyDE description string from the HydeGenerator.
+     */
+    hydeDescription: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Error message if any step fails (non-fatal).
+     */
+    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /**
+     * Tracks which operations were actually performed during this graph execution.
+     * Used to provide explicit feedback to the user about what happened.
+     */
+    operationsPerformed: import("@langchain/langgraph").BaseChannel<{
+        scraped?: boolean;
+        generatedProfile?: boolean;
+        embeddedProfile?: boolean;
+        generatedHyde?: boolean;
+        embeddedHyde?: boolean;
+    }, {
+        scraped?: boolean;
+        generatedProfile?: boolean;
+        embeddedProfile?: boolean;
+        generatedHyde?: boolean;
+        embeddedHyde?: boolean;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        scraped?: boolean;
+        generatedProfile?: boolean;
+        embeddedProfile?: boolean;
+        generatedHyde?: boolean;
+        embeddedHyde?: boolean;
+    }>, unknown>;
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: import("@langchain/langgraph").BaseChannel<DebugMetaAgent[], DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]>, unknown>;
+    /**
+     * Output for query mode: structured result for the tool to read.
+     */
+    readResult: import("@langchain/langgraph").BaseChannel<{
+        hasProfile: boolean;
+        profile?: {
+            id?: string;
+            name: string;
+            bio: string;
+            location: string;
+            skills: string[];
+            interests: string[];
+        };
+        message?: string;
+    } | undefined, {
+        hasProfile: boolean;
+        profile?: {
+            id?: string;
+            name: string;
+            bio: string;
+            location: string;
+            skills: string[];
+            interests: string[];
+        };
+        message?: string;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        hasProfile: boolean;
+        profile?: {
+            id?: string;
+            name: string;
+            bio: string;
+            location: string;
+            skills: string[];
+            interests: string[];
+        };
+        message?: string;
+    } | undefined> | undefined, unknown>;
+}>;
+//# sourceMappingURL=profile.state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.state.d.ts","sourceRoot":"","sources":["../../src/states/profile.state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAE5B;;OAEG;;;;;;IAKH;;;;;OAKG;;IAMH;;;OAGG;;IAQH;;;OAGG;;kBAES;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;mBAC9C;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE;oBAClB;YAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAAC,SAAS,EAAE,MAAM,EAAE,CAAA;SAAE;;kBAF3C;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;mBAC9C;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE;oBAClB;YAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAAC,SAAS,EAAE,MAAM,EAAE,CAAA;SAAE;;kBAF3C;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;mBAC9C;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE;oBAClB;YAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAAC,SAAS,EAAE,MAAM,EAAE,CAAA;SAAE;;IAMvD;;OAEG;;IAMH;;OAEG;;IAMH;;;OAGG;;IAMH;;OAEG;;;;;IAqBH;;;OAGG;;IAMH;;;OAGG;;IAQH;;OAEG;;IAMH;;OAEG;;IAQH;;;OAGG;;kBAES,OAAO;2BACE,OAAO;0BACR,OAAO;wBACT,OAAO;uBACR,OAAO;;kBAJZ,OAAO;2BACE,OAAO;0BACR,OAAO;wBACT,OAAO;uBACR,OAAO;;kBAJZ,OAAO;2BACE,OAAO;0BACR,OAAO;wBACT,OAAO;uBACR,OAAO;;IAMxB,sEAAsE;;IAMtE;;OAEG;;oBAEW,OAAO;kBACT;YACR,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,GAAG,EAAE,MAAM,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,SAAS,EAAE,MAAM,EAAE,CAAC;SACrB;kBACS,MAAM;;oBATJ,OAAO;kBACT;YACR,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,GAAG,EAAE,MAAM,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,SAAS,EAAE,MAAM,EAAE,CAAC;SACrB;kBACS,MAAM;;oBATJ,OAAO;kBACT;YACR,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,GAAG,EAAE,MAAM,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,SAAS,EAAE,MAAM,EAAE,CAAC;SACrB;kBACS,MAAM;;EAKlB,CAAC"}

package/dist/states/profile.state.js

@@ -0,0 +1,133 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * The Graph State for Profile Generation.
+ */
+export const ProfileGraphState = Annotation.Root({
+    // --- Inputs (Required at start) ---
+    /**
+     * The User ID to link the profile to.
+     */
+    userId: (Annotation),
+    // --- Control Fields (Operation Mode) ---
+    /**
+     * Operation mode controls graph flow:
+     * - 'query': Fast path - only retrieve existing profile (no generation)
+     * - 'write': Full pipeline - generate/update profile and hyde as needed
+     * - 'generate': Auto-generate profile from user table data via enrichUserProfile Chat API
+     */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'write',
+    }),
+    /**
+     * Flag to force profile regeneration even if profile exists.
+     * When true with new input, the graph will re-generate and update the profile.
+     */
+    forceUpdate: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    // --- Intermediate State ---
+    /**
+     * Pre-populated profile from external enrichment (e.g. Parallel Chat API).
+     * When provided, the graph skips profile generation and only runs embedding + HyDE.
+     */
+    prePopulatedProfile: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * Internal objective constructed from user data.
+     */
+    objective: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * Raw input data (either provided or scraped).
+     */
+    input: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * The generated or loaded profile document.
+     * Includes embedding from DB. Profile HyDE is stored in hyde_documents.
+     */
+    profile: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * Flags to track what needs to be generated.
+     */
+    needsProfileGeneration: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    needsProfileEmbedding: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    needsHydeGeneration: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    needsHydeEmbedding: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    /**
+     * Flag indicating that user information is insufficient for accurate profile generation.
+     * When true, the graph should request additional information from the user.
+     */
+    needsUserInfo: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    /**
+     * List of missing user information fields.
+     * Used to construct a helpful clarification message.
+     */
+    missingUserInfo: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => [],
+    }),
+    // --- Output ---
+    /**
+     * The generated HyDE description string from the HydeGenerator.
+     */
+    hydeDescription: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * Error message if any step fails (non-fatal).
+     */
+    error: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+    // --- Operation Tracking (for transparency) ---
+    /**
+     * Tracks which operations were actually performed during this graph execution.
+     * Used to provide explicit feedback to the user about what happened.
+     */
+    operationsPerformed: Annotation({
+        reducer: (curr, next) => ({ ...curr, ...next }),
+        default: () => ({}),
+    }),
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: Annotation({
+        reducer: (acc, val) => [...acc, ...val],
+        default: () => [],
+    }),
+    /**
+     * Output for query mode: structured result for the tool to read.
+     */
+    readResult: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+});
+//# sourceMappingURL=profile.state.js.map

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

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

package/dist/streamers/chat.streamer.d.ts

@@ -0,0 +1,55 @@
+import { BaseMessage } from "@langchain/core/messages";
+import { BaseCheckpointSaver } from "@langchain/langgraph";
+import type { ChatStreamEvent } from "../types/chat-streaming.types.js";
+/**
+ * Top-level streaming service for Chat Graph events.
+ *
+ * Uses `graph.stream()` with `streamMode: ["custom", "updates"]` so that
+ * the agent's `config.writer()` calls arrive as `"custom"` chunks (text
+ * tokens and tool-activity events) and the final state update arrives as
+ * an `"updates"` chunk.
+ */
+export declare class ChatStreamer {
+    private loadSessionContext;
+    private createStreamingGraph;
+    constructor(loadSessionContext: (sessionId: string, maxMessages: number) => Promise<BaseMessage[]>, createStreamingGraph: (checkpointer?: BaseCheckpointSaver) => any);
+    /**
+     * Streams chat events with full session context.
+     * Loads previous conversation history and optionally uses a checkpointer
+     * for state persistence.
+     *
+     * @param input - Configuration for context-aware streaming
+     * @param checkpointer - Optional checkpointer for state persistence
+     * @yields ChatStreamEvent objects
+     */
+    streamChatEventsWithContext(input: {
+        userId: string;
+        message: string;
+        sessionId: string;
+        maxContextMessages?: number;
+        indexId?: string;
+        prefillMessages?: Array<{
+            role: "assistant" | "user";
+            content: string;
+        }>;
+    }, checkpointer?: BaseCheckpointSaver, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
+    /**
+     * Streams chat events from the graph execution.
+     *
+     * Uses `graph.stream()` with `streamMode: ["custom", "updates"]`:
+     * - `"custom"` chunks carry {@link AgentStreamEvent} objects emitted by
+     *   `ChatAgent.streamRun()` via `config.writer()`
+     * - `"updates"` chunks carry the final state update from `agentLoopNode`
+     *
+     * @param input - The input state for the graph (userId and messages)
+     * @param sessionId - The session ID for event attribution
+     * @param checkpointer - Optional checkpointer for persistence
+     * @yields ChatStreamEvent objects
+     */
+    streamChatEvents(input: {
+        userId: string;
+        messages: BaseMessage[];
+        indexId?: string;
+    }, sessionId: string, checkpointer?: BaseCheckpointSaver, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
+}
+//# sourceMappingURL=chat.streamer.d.ts.map

package/dist/streamers/chat.streamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.streamer.d.ts","sourceRoot":"","sources":["../../src/streamers/chat.streamer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAgB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,kCAAkC,CAAC;AA0B1C;;;;;;;GAOG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,oBAAoB;gBAJpB,kBAAkB,EAAE,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,WAAW,EAAE,CAAC,EACnB,oBAAoB,EAAE,CAC5B,YAAY,CAAC,EAAE,mBAAmB,KAC/B,GAAG;IAGV;;;;;;;;OAQG;IACW,2BAA2B,CACvC,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC1E,EACD,YAAY,CAAC,EAAE,mBAAmB,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,eAAe,CAAC;IA4DlC;;;;;;;;;;;;OAYG;IACW,gBAAgB,CAC5B,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EACpE,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,mBAAmB,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,eAAe,CAAC;CAqKnC"}

package/dist/streamers/chat.streamer.js

@@ -0,0 +1,186 @@
+import { AIMessage, HumanMessage } from "@langchain/core/messages";
+import { protocolLogger } from "../support/protocol.logger.js";
+import { createAgentEndEvent, createAgentStartEvent, createDebugMetaEvent, createErrorEvent, createGraphEndEvent, createGraphStartEvent, createIterationStartEvent, createLlmStartEvent, createLlmEndEvent, createResponseCompleteEvent, createResponseResetEvent, createHallucinationDetectedEvent, createStatusEvent, createTokenEvent, createToolActivityEvent, } from "../types/chat-streaming.types.js";
+const logger = protocolLogger("ChatStreamer");
+// ══════════════════════════════════════════════════════════════════════════════
+// CHAT STREAMER (Streaming Narration Architecture)
+// ══════════════════════════════════════════════════════════════════════════════
+/**
+ * Top-level streaming service for Chat Graph events.
+ *
+ * Uses `graph.stream()` with `streamMode: ["custom", "updates"]` so that
+ * the agent's `config.writer()` calls arrive as `"custom"` chunks (text
+ * tokens and tool-activity events) and the final state update arrives as
+ * an `"updates"` chunk.
+ */
+export class ChatStreamer {
+    constructor(loadSessionContext, createStreamingGraph) {
+        this.loadSessionContext = loadSessionContext;
+        this.createStreamingGraph = createStreamingGraph;
+    }
+    /**
+     * Streams chat events with full session context.
+     * Loads previous conversation history and optionally uses a checkpointer
+     * for state persistence.
+     *
+     * @param input - Configuration for context-aware streaming
+     * @param checkpointer - Optional checkpointer for state persistence
+     * @yields ChatStreamEvent objects
+     */
+    async *streamChatEventsWithContext(input, checkpointer, signal) {
+        const { userId, message, sessionId, maxContextMessages = 20, indexId, prefillMessages, } = input;
+        logger.verbose("Starting context-aware streaming", {
+            userId,
+            sessionId,
+            maxContextMessages,
+            hasCheckpointer: !!checkpointer,
+            hasIndexId: !!indexId,
+            indexId: indexId ?? undefined,
+        });
+        try {
+            // Load previous conversation context
+            const previousMessages = await this.loadSessionContext(sessionId, maxContextMessages);
+            // Inject prefill messages (e.g. hardcoded onboarding greeting) only for fresh sessions
+            const prefill = previousMessages.length === 0
+                ? (prefillMessages ?? []).map((pm) => pm.role === "assistant" ? new AIMessage(pm.content) : new HumanMessage(pm.content))
+                : [];
+            const allMessages = [...previousMessages, ...prefill, new HumanMessage(message)];
+            logger.verbose("Context prepared", {
+                previousCount: previousMessages.length,
+                totalCount: allMessages.length,
+            });
+            // Stream with context using the optional checkpointer
+            yield* this.streamChatEvents({ userId, messages: allMessages, indexId }, sessionId, checkpointer, signal);
+        }
+        catch (error) {
+            logger.error("Stream error", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            yield createErrorEvent(sessionId, error instanceof Error
+                ? error.message
+                : "Unknown error during context-aware streaming", "CONTEXT_STREAM_ERROR");
+        }
+    }
+    /**
+     * Streams chat events from the graph execution.
+     *
+     * Uses `graph.stream()` with `streamMode: ["custom", "updates"]`:
+     * - `"custom"` chunks carry {@link AgentStreamEvent} objects emitted by
+     *   `ChatAgent.streamRun()` via `config.writer()`
+     * - `"updates"` chunks carry the final state update from `agentLoopNode`
+     *
+     * @param input - The input state for the graph (userId and messages)
+     * @param sessionId - The session ID for event attribution
+     * @param checkpointer - Optional checkpointer for persistence
+     * @yields ChatStreamEvent objects
+     */
+    async *streamChatEvents(input, sessionId, checkpointer, signal) {
+        const graph = this.createStreamingGraph(checkpointer);
+        try {
+            const initialState = {
+                userId: input.userId,
+                messages: input.messages,
+            };
+            if (input.indexId)
+                initialState.indexId = input.indexId;
+            initialState.sessionId = sessionId;
+            // Use graph.stream() with custom + updates modes.
+            // Custom events come from config.writer() inside agentLoopNode.
+            const eventStream = await graph.stream(initialState, {
+                streamMode: ["custom", "updates"],
+                configurable: { thread_id: sessionId, signal },
+                signal,
+            });
+            // Emit initial status
+            yield createStatusEvent(sessionId, "Processing your message...");
+            for await (const tuple of eventStream) {
+                if (signal?.aborted)
+                    break;
+                // graph.stream with multiple modes yields [mode, chunk] tuples
+                const [mode, chunk] = tuple;
+                // ─────────────────────────────────────────────────────────────────
+                // CUSTOM: writer events from ChatAgent.streamRun()
+                // ─────────────────────────────────────────────────────────────────
+                if (mode === "custom") {
+                    const event = chunk;
+                    if (event.type === "iteration_start") {
+                        yield createIterationStartEvent(sessionId, event.iteration);
+                    }
+                    if (event.type === "llm_start") {
+                        yield createLlmStartEvent(sessionId, event.iteration);
+                    }
+                    if (event.type === "text_chunk" && event.content) {
+                        yield createTokenEvent(sessionId, event.content);
+                    }
+                    if (event.type === "response_reset") {
+                        yield createResponseResetEvent(sessionId, event.reason);
+                    }
+                    if (event.type === "hallucination_detected") {
+                        yield createHallucinationDetectedEvent(sessionId, event.blockType, event.tool);
+                    }
+                    if (event.type === "llm_end") {
+                        yield createLlmEndEvent(sessionId, event.iteration, event.hasToolCalls, event.toolNames);
+                    }
+                    if (event.type === "tool_activity") {
+                        logger.debug("Tool activity", { name: event.name, phase: event.phase });
+                        if (event.phase === "start") {
+                            yield createToolActivityEvent(sessionId, event.name, event.name, "start");
+                        }
+                        else {
+                            yield createToolActivityEvent(sessionId, event.name, event.name, "end", event.success, event.summary, event.steps);
+                        }
+                    }
+                    if (event.type === "graph_start") {
+                        yield createGraphStartEvent(sessionId, event.name);
+                    }
+                    if (event.type === "graph_end") {
+                        yield createGraphEndEvent(sessionId, event.name, event.durationMs);
+                    }
+                    if (event.type === "agent_start") {
+                        yield createAgentStartEvent(sessionId, event.name);
+                    }
+                    if (event.type === "agent_end") {
+                        yield createAgentEndEvent(sessionId, event.name, event.durationMs, event.summary);
+                    }
+                }
+                // ─────────────────────────────────────────────────────────────────
+                // UPDATES: final state from agentLoopNode
+                // ─────────────────────────────────────────────────────────────────
+                if (mode === "updates") {
+                    // The updates chunk is { agent_loop: { responseText, error, ... } }
+                    const updates = chunk;
+                    const agentOutput = updates?.agent_loop;
+                    if (agentOutput?.error) {
+                        logger.warn("Agent loop returned error via updates", {
+                            error: agentOutput.error,
+                        });
+                        yield createErrorEvent(sessionId, String(agentOutput.error), "AGENT_ERROR");
+                    }
+                    // Yield the agent's authoritative response text so the
+                    // controller can persist it without relying on token accumulation.
+                    const responseText = typeof agentOutput?.responseText === "string"
+                        ? agentOutput.responseText
+                        : "";
+                    yield createResponseCompleteEvent(sessionId, responseText);
+                    const debugMeta = agentOutput?.debugMeta;
+                    if (debugMeta?.graph != null &&
+                        typeof debugMeta.iterations === "number") {
+                        yield createDebugMetaEvent(sessionId, debugMeta.graph, debugMeta.iterations, Array.isArray(debugMeta.tools) ? debugMeta.tools : []);
+                    }
+                    logger.verbose("Agent loop complete (updates)", {
+                        responseLength: responseText.length,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            logger.error("Stream error", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            yield createErrorEvent(sessionId, error instanceof Error
+                ? error.message
+                : "Unknown error during streaming", "STREAM_ERROR");
+        }
+    }
+}
+//# sourceMappingURL=chat.streamer.js.map

package/dist/streamers/chat.streamer.js.map

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

package/dist/streamers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './chat.streamer.js';
+export * from './response.streamer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/streamers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streamers/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/streamers/index.js

@@ -0,0 +1,3 @@
+export * from './chat.streamer.js';
+export * from './response.streamer.js';
+//# sourceMappingURL=index.js.map

package/dist/streamers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/streamers/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/streamers/response.streamer.d.ts

@@ -0,0 +1,36 @@
+import type { ChatStreamEvent } from "../types/chat-streaming.types.js";
+/**
+ * Streams the final response from the chat agent.
+ *
+ * Processes the `on_chain_end` event emitted by the `agent_loop` node and
+ * yields either a token event (with the full response text) or an error event.
+ *
+ * Note on token streaming:
+ * We do NOT emit from `on_chat_model_stream` because `streamEvents` yields
+ * events from ALL model invocations, including nested ones
+ * (ExplicitIntentInferrer, SemanticVerifier, IntentReconciler, IntentIndexer)
+ * inside tools. Those emit structured JSON that must not reach the user. The
+ * chat agent uses `model.invoke()` so we don't get token-by-token streaming
+ * anyway. We only emit the clean final response from `on_chain_end`.
+ */
+export declare class ResponseStreamer {
+    /**
+     * Processes an `on_chain_end` event whose name is `agent_loop`.
+     *
+     * @returns An array of stream events to yield (token and/or error), plus
+     *          metadata for the caller to log.
+     */
+    handleAgentLoopEnd(sessionId: string, event: {
+        data?: {
+            output?: {
+                responseText?: string;
+                error?: string;
+            };
+        };
+    }): {
+        events: ChatStreamEvent[];
+        responseText: string;
+        hadError: boolean;
+    };
+}
+//# sourceMappingURL=response.streamer.d.ts.map

package/dist/streamers/response.streamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.streamer.d.ts","sourceRoot":"","sources":["../../src/streamers/response.streamer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAaxE;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE;gBAAE,YAAY,CAAC,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,GACvE;QAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;CA4B1E"}