@indexnetwork/protocol 17.0.1-rc.480.1 → 18.0.0-rc.481.1

package/dist/intents/intent.module.d.ts

@@ -0,0 +1,633 @@
+/**
+ * intents — the capability's single public surface.
+ *
+ * Everything the rest of the package (and every host) may reach lives on the
+ * {@link Intents} class. The directories beside this file are private
+ * implementation, grouped by what they do rather than by layer:
+ *
+ *   graph/               the lifecycle graph — prep, infer, verify, reconcile, execute
+ *   intake/              the guided first-signal interview
+ *   intent.inferrer      an utterance into candidate signals
+ *   intent.reconciler    candidate signals into create/update/expire actions
+ *   intent.verifier      felicity and entropy verdicts
+ *   intent.clarifier     the clarification path when a signal is underspecified
+ *   intent.indexer       scoring one signal against one network
+ *   intent.proposal      the persisted proposal record and description normalization
+ *   intent.tools         the agent-facing tool definitions
+ *
+ * Only the two multi-file stages keep a directory. Nothing outside `intents/`
+ * imports any of it; the layout may change freely as long as this class keeps
+ * its shape.
+ */
+import type { DefineTool } from "../shared/agent/tool.helpers.js";
+import type { IntentGraphDatabase } from "../shared/interfaces/database.interface.js";
+import type { EmbeddingGenerator } from "../shared/interfaces/embedder.interface.js";
+import type { IntentGraphQueue } from "../shared/interfaces/queue.interface.js";
+import type { QuestionerEnqueueFn } from "../questions/index.js";
+import { ExplicitIntentInferrer } from "./intent.inferrer.js";
+import { IntentReconciler } from "./intent.reconciler.js";
+import { SemanticVerifier } from "./intent.verifier.js";
+import type { IntentIndexerOutput } from "./intent.indexer.js";
+import type { FollowUpPlan, FollowUpPlanInput, IntakeAnswer, IntakeRound, SynthesisInput, SynthesisResult } from "./intake/intake.orchestrator.js";
+import type { IntakePack, IntakePackInput, IntakePackQuestion, IntakePackQuestionOption } from "./intake/intake.pack.generator.js";
+import type { IntentToolDeps } from "./intent.tools.js";
+export type { FollowUpPlan, FollowUpPlanInput, IntakeAnswer, IntakePack, IntakePackInput, IntakePackQuestion, IntakePackQuestionOption, IntakeRound, IntentIndexerOutput, IntentToolDeps, SynthesisInput, SynthesisResult, };
+/**
+ * Host capabilities the intent lifecycle needs.
+ *
+ * Every field is optional: a host that only wants the model-backed helpers
+ * (verification, indexing, intake) can construct `new Intents()` with nothing.
+ * {@link Intents.createGraph} is the one method that requires `database`.
+ */
+export interface IntentsDeps {
+    /** Signal persistence. Required by {@link Intents.createGraph}. */
+    database?: IntentGraphDatabase;
+    /** Embedding generator used to vectorize executed signals. */
+    embedder?: EmbeddingGenerator;
+    /** Queue that picks up post-execution work (network assignment, discovery). */
+    queue?: IntentGraphQueue;
+    /** Enqueues decision-question generation after a signal lands. */
+    questionerEnqueue?: QuestionerEnqueueFn;
+    /**
+     * Model-backed stages, injectable so tests can run the graph without a model.
+     * Omitted stages construct their canonical implementation on first use.
+     */
+    agents?: {
+        inferrer?: Pick<ExplicitIntentInferrer, "invoke">;
+        verifier?: Pick<SemanticVerifier, "invoke">;
+        reconciler?: Pick<IntentReconciler, "invoke">;
+    };
+}
+/**
+ * The intents capability.
+ *
+ * One instance is cheap: the model-backed collaborators behind each method are
+ * constructed on first use and then reused, so a host can hold a single
+ * `Intents` and call only the parts it needs without paying for the rest.
+ */
+export declare class Intents {
+    private readonly deps;
+    private indexer?;
+    private verifier?;
+    private orchestrator?;
+    private packGenerator?;
+    constructor(deps?: IntentsDeps);
+    /**
+     * Build the intent lifecycle graph — load, infer, verify, reconcile, execute.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
+        userId: string;
+        userProfile: string;
+        inputContent: string | undefined;
+        conversationContext: import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined;
+        operationMode: "update" | "propose" | "create" | "delete" | "read";
+        targetIntentIds: string[] | undefined;
+        expectedIntentFingerprint: string | undefined;
+        networkId: string | undefined;
+        scopeType: import("../index.js").ToolScopeType | undefined;
+        scopeId: string | undefined;
+        activeIntents: string;
+        activeIntentIds: string[];
+        inferredIntents: {
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[];
+        verifiedIntents: import("./graph/intent.graph.state.js").VerifiedIntent[];
+        validationFailures: import("./graph/intent.graph.state.js").IntentValidationFailure[];
+        actions: import("./intent.reconciler.js").NormalizedIntentAction[];
+        executionResults: import("./graph/intent.graph.state.js").ExecutionResult[];
+        error: string | undefined;
+        trace: {
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[];
+        agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+        indexScope: string[] | undefined;
+        queryUserId: string | undefined;
+        allUserIntents: boolean;
+        readResult: {
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | undefined;
+    }, {
+        userId?: string | undefined;
+        userProfile?: string | undefined;
+        inputContent?: string | undefined;
+        conversationContext?: import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined> | undefined;
+        operationMode?: "update" | "propose" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "propose" | "create" | "delete" | "read"> | undefined;
+        targetIntentIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined;
+        expectedIntentFingerprint?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        scopeType?: import("../index.js").ToolScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ToolScopeType | undefined> | undefined;
+        scopeId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        activeIntents?: string | import("@langchain/langgraph").OverwriteValue<string> | undefined;
+        activeIntentIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[]> | undefined;
+        inferredIntents?: {
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[] | import("@langchain/langgraph").OverwriteValue<{
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[]> | undefined;
+        verifiedIntents?: import("./graph/intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").VerifiedIntent[]> | undefined;
+        validationFailures?: import("./graph/intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").IntentValidationFailure[]> | undefined;
+        actions?: import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]> | undefined;
+        executionResults?: import("./graph/intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").ExecutionResult[]> | undefined;
+        error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        trace?: {
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[] | import("@langchain/langgraph").OverwriteValue<{
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[]> | undefined;
+        agentTimings?: import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]> | undefined;
+        indexScope?: string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined;
+        queryUserId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        allUserIntents?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
+        readResult?: {
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | undefined> | undefined;
+    }, "query" | "__start__" | "prep" | "inference" | "verification" | "reconciler" | "executor", {
+        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>;
+        };
+        userProfile: {
+            (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>;
+        };
+        inputContent: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | undefined, string | undefined>): import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        conversationContext: import("@langchain/langgraph").BaseChannel<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined, import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined> | undefined, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"update" | "propose" | "create" | "delete" | "read", "update" | "propose" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "propose" | "create" | "delete" | "read">, unknown>;
+        targetIntentIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ToolScopeType | undefined, import("../index.js").ToolScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ToolScopeType | undefined> | undefined, unknown>;
+        scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        activeIntents: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+        activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+        inferredIntents: import("@langchain/langgraph").BaseChannel<{
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[], {
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[] | import("@langchain/langgraph").OverwriteValue<{
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[]>, unknown>;
+        verifiedIntents: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").VerifiedIntent[], import("./graph/intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").VerifiedIntent[]>, unknown>;
+        validationFailures: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").IntentValidationFailure[], import("./graph/intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").IntentValidationFailure[]>, unknown>;
+        actions: import("@langchain/langgraph").BaseChannel<import("./intent.reconciler.js").NormalizedIntentAction[], import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+        executionResults: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").ExecutionResult[], import("./graph/intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").ExecutionResult[]>, unknown>;
+        error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        trace: import("@langchain/langgraph").BaseChannel<{
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[], {
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[] | import("@langchain/langgraph").OverwriteValue<{
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[]>, unknown>;
+        agentTimings: import("@langchain/langgraph").BaseChannel<import("../chat/chat-streaming.types.js").DebugMetaAgent[], import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]>, unknown>;
+        indexScope: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        allUserIntents: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | undefined, {
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | undefined> | undefined, unknown>;
+    }, {
+        userId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+            (): import("@langchain/langgraph").LastValue<string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        userProfile: {
+            (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>;
+        };
+        inputContent: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | undefined, string | undefined>): import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        conversationContext: import("@langchain/langgraph").BaseChannel<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined, import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined> | undefined, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"update" | "propose" | "create" | "delete" | "read", "update" | "propose" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "propose" | "create" | "delete" | "read">, unknown>;
+        targetIntentIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ToolScopeType | undefined, import("../index.js").ToolScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ToolScopeType | undefined> | undefined, unknown>;
+        scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        activeIntents: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+        activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+        inferredIntents: import("@langchain/langgraph").BaseChannel<{
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[], {
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[] | import("@langchain/langgraph").OverwriteValue<{
+            reasoning: string;
+            type: "goal" | "tombstone";
+            confidence: "low" | "medium" | "high";
+            description: string;
+        }[]>, unknown>;
+        verifiedIntents: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").VerifiedIntent[], import("./graph/intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").VerifiedIntent[]>, unknown>;
+        validationFailures: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").IntentValidationFailure[], import("./graph/intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").IntentValidationFailure[]>, unknown>;
+        actions: import("@langchain/langgraph").BaseChannel<import("./intent.reconciler.js").NormalizedIntentAction[], import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+        executionResults: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").ExecutionResult[], import("./graph/intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").ExecutionResult[]>, unknown>;
+        error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        trace: import("@langchain/langgraph").BaseChannel<{
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[], {
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[] | import("@langchain/langgraph").OverwriteValue<{
+            node: string;
+            detail?: string;
+            data?: Record<string, unknown>;
+        }[]>, unknown>;
+        agentTimings: import("@langchain/langgraph").BaseChannel<import("../chat/chat-streaming.types.js").DebugMetaAgent[], import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]>, unknown>;
+        indexScope: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+        queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        allUserIntents: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+        readResult: import("@langchain/langgraph").BaseChannel<{
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | undefined, {
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | import("@langchain/langgraph").OverwriteValue<{
+            count: number;
+            intents: Array<{
+                id: string;
+                description: string;
+                summary: string | null;
+                createdAt: Date;
+                userId?: string;
+                userName?: string | null;
+            }>;
+            message?: string;
+            networkId?: string;
+        } | undefined> | undefined, unknown>;
+    }, import("@langchain/langgraph").StateDefinition, {
+        prep: {
+            error: string;
+            activeIntents?: undefined;
+            activeIntentIds?: undefined;
+            trace?: undefined;
+        } | {
+            activeIntents: string;
+            activeIntentIds: string[];
+            trace: {
+                node: string;
+                detail: string;
+            }[];
+            error?: undefined;
+        };
+        query: {
+            readResult: {
+                count: number;
+                intents: never[];
+                message: string;
+                networkId?: undefined;
+            };
+        } | {
+            readResult: {
+                count: number;
+                intents: {
+                    id: string;
+                    description: string;
+                    summary: string | null;
+                    createdAt: Date;
+                }[];
+                message?: undefined;
+                networkId?: undefined;
+            };
+        } | {
+            readResult: {
+                count: number;
+                intents: never[];
+                message: string;
+                networkId: string;
+            };
+        } | {
+            readResult: {
+                count: number;
+                networkId: string;
+                intents: {
+                    id: string;
+                    description: string;
+                    summary: string | null;
+                    createdAt: Date;
+                    userId: string;
+                    userName: string | null;
+                }[];
+                message?: undefined;
+            };
+        };
+        inference: {
+            inferredIntents: {
+                reasoning: string;
+                type: "goal" | "tombstone";
+                confidence: "low" | "medium" | "high";
+                description: string;
+            }[];
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            trace: {
+                node: string;
+                detail: string;
+            }[];
+        };
+        verification: {
+            verifiedIntents: never[];
+            agentTimings: never[];
+            validationFailures?: undefined;
+            trace?: undefined;
+        } | {
+            verifiedIntents: import("./graph/intent.graph.state.js").VerifiedIntent[];
+            validationFailures: import("./graph/intent.graph.state.js").IntentValidationFailure[];
+            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            trace: {
+                node: string;
+                detail: string;
+                data: {
+                    clarity: number;
+                    authority: number;
+                    sincerity: number;
+                    entropy: number | undefined;
+                    referentialBreadth: "narrow" | "moderate" | "broad" | undefined;
+                    missingSelectionalConstraints: ("location" | "role" | "outcome" | "timeframe" | "domain" | "concrete_need")[] | undefined;
+                    specificityWarning: string | undefined;
+                    classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN" | undefined;
+                    score: number | undefined;
+                } | undefined;
+            }[];
+        };
+        reconciler: import("@langchain/langgraph").UpdateType<{
+            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>;
+            };
+            userProfile: {
+                (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>;
+            };
+            inputContent: {
+                (annotation: import("@langchain/langgraph").SingleReducer<string | undefined, string | undefined>): import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+                (): import("@langchain/langgraph").LastValue<string | undefined>;
+                Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+            };
+            conversationContext: import("@langchain/langgraph").BaseChannel<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined, import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<import("@langchain/core/messages").BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | undefined> | undefined, unknown>;
+            operationMode: import("@langchain/langgraph").BaseChannel<"update" | "propose" | "create" | "delete" | "read", "update" | "propose" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "propose" | "create" | "delete" | "read">, unknown>;
+            targetIntentIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+            expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ToolScopeType | undefined, import("../index.js").ToolScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ToolScopeType | undefined> | undefined, unknown>;
+            scopeId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            activeIntents: import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
+            activeIntentIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+            inferredIntents: import("@langchain/langgraph").BaseChannel<{
+                reasoning: string;
+                type: "goal" | "tombstone";
+                confidence: "low" | "medium" | "high";
+                description: string;
+            }[], {
+                reasoning: string;
+                type: "goal" | "tombstone";
+                confidence: "low" | "medium" | "high";
+                description: string;
+            }[] | import("@langchain/langgraph").OverwriteValue<{
+                reasoning: string;
+                type: "goal" | "tombstone";
+                confidence: "low" | "medium" | "high";
+                description: string;
+            }[]>, unknown>;
+            verifiedIntents: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").VerifiedIntent[], import("./graph/intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").VerifiedIntent[]>, unknown>;
+            validationFailures: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").IntentValidationFailure[], import("./graph/intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").IntentValidationFailure[]>, unknown>;
+            actions: import("@langchain/langgraph").BaseChannel<import("./intent.reconciler.js").NormalizedIntentAction[], import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+            executionResults: import("@langchain/langgraph").BaseChannel<import("./graph/intent.graph.state.js").ExecutionResult[], import("./graph/intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./graph/intent.graph.state.js").ExecutionResult[]>, unknown>;
+            error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            trace: import("@langchain/langgraph").BaseChannel<{
+                node: string;
+                detail?: string;
+                data?: Record<string, unknown>;
+            }[], {
+                node: string;
+                detail?: string;
+                data?: Record<string, unknown>;
+            }[] | import("@langchain/langgraph").OverwriteValue<{
+                node: string;
+                detail?: string;
+                data?: Record<string, unknown>;
+            }[]>, unknown>;
+            agentTimings: import("@langchain/langgraph").BaseChannel<import("../chat/chat-streaming.types.js").DebugMetaAgent[], import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]>, unknown>;
+            indexScope: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
+            queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+            allUserIntents: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+            readResult: import("@langchain/langgraph").BaseChannel<{
+                count: number;
+                intents: Array<{
+                    id: string;
+                    description: string;
+                    summary: string | null;
+                    createdAt: Date;
+                    userId?: string;
+                    userName?: string | null;
+                }>;
+                message?: string;
+                networkId?: string;
+            } | undefined, {
+                count: number;
+                intents: Array<{
+                    id: string;
+                    description: string;
+                    summary: string | null;
+                    createdAt: Date;
+                    userId?: string;
+                    userName?: string | null;
+                }>;
+                message?: string;
+                networkId?: string;
+            } | import("@langchain/langgraph").OverwriteValue<{
+                count: number;
+                intents: Array<{
+                    id: string;
+                    description: string;
+                    summary: string | null;
+                    createdAt: Date;
+                    userId?: string;
+                    userName?: string | null;
+                }>;
+                message?: string;
+                networkId?: string;
+            } | undefined> | undefined, unknown>;
+        }>;
+        executor: {
+            executionResults: import("./graph/intent.graph.state.js").ExecutionResult[];
+        };
+    }, unknown, unknown, []>;
+    /**
+     * Verify one utterance against the speaker's profile — felicity conditions,
+     * speech-act classification, semantic entropy, and specificity.
+     *
+     * @param content - The raw utterance.
+     * @param profileContext - The speaker's profile, serialized as JSON.
+     */
+    verifyIntent(content: string, profileContext: string): Promise<{
+        reasoning: string;
+        classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
+        felicity_scores: {
+            clarity: number;
+            authority: number;
+            sincerity: number;
+        };
+        semantic_entropy: number;
+        referential_anchor: string | null;
+        referential_breadth: "narrow" | "moderate" | "broad";
+        missing_selectional_constraints: ("location" | "role" | "outcome" | "timeframe" | "domain" | "concrete_need")[];
+        specificity_warning: string | null;
+        flags: string[];
+    }>;
+    /**
+     * Score how well one signal fits one network, from the network's purpose and
+     * the member's sharing preferences.
+     *
+     * @returns Scores and reasoning, or `null` when the model call fails.
+     */
+    indexIntent(intent: string, indexPrompt: string | null, memberPrompt: string | null, sourceName?: string | null, networkContext?: string | null): Promise<IntentIndexerOutput | null>;
+    /** Generate a participant's intake brief and round-1 question. */
+    generateIntakePack(input: IntakePackInput): Promise<IntakePack>;
+    /** Plan and write the next intake follow-up questions. */
+    generateIntakeFollowUps(input: FollowUpPlanInput): Promise<FollowUpPlan>;
+    /** Turn answered intake rounds into a signal description and card summary. */
+    synthesizeIntake(input: SynthesisInput): Promise<SynthesisResult>;
+    /** The static round-1 question used when pack generation is unavailable. */
+    static readonly FALLBACK_INTAKE_QUESTION: IntakePackQuestion;
+    /** Normalize a signal description to its persisted form. */
+    static normalizeDescription(description: string): string;
+    /** Register the agent-facing intent tools against a tool definer. */
+    static createTools(defineTool: DefineTool, deps: IntentToolDeps): readonly [any, any, any, any, any, any, any, any];
+}