@indexnetwork/protocol 22.0.0-rc.498.1 → 64.0.0-rc.604.2

package/dist/capabilities/intents.js

@@ -0,0 +1,88 @@
+/**
+ * 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 — prepare/create; infer/verify explicit updates
+ *   intent.inferrer      an utterance into candidate signals
+ *   intent.verifier      felicity and entropy verdicts
+ *   intent.preparer        a typed payload into an admitted draft or recovery form
+ *
+ * Only the graph keeps a directory. Nothing outside `intents/` imports any of
+ * it; the layout may change freely as long as this class keeps its shape.
+ */
+import { IntentGraphFactory } from "../internal/intents/graph/intent.graph.js";
+import { normalizeIntentDescription } from "../internal/intents/graph/intent.graph.shared.js";
+import { IntentPreparer } from "../internal/intents/intent.preparer.js";
+import { semanticMetadata } from "../internal/intents/intent.admission.js";
+import { SemanticVerifier } from "../internal/intents/intent.verifier.js";
+/**
+ * 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 class Intents {
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    // ── Lifecycle graph ─────────────────────────────────────────────────────────
+    /**
+     * Build the intent lifecycle graph — prepare and create, or explicitly read, update, archive, and transition.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createGraph() {
+        const { database, embedder, followUp, agents } = this.deps;
+        if (!database) {
+            throw new Error("Intents.createGraph() requires a `database` dependency.");
+        }
+        return new IntentGraphFactory(database, embedder, followUp, agents).createGraph();
+    }
+    // ── Verification ────────────────────────────────────────────────────────────
+    /**
+     * 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.
+     */
+    async verifyIntent(content, profileContext) {
+        this.verifier ?? (this.verifier = this.deps.agents?.verifier ?? new SemanticVerifier());
+        return this.verifier.invoke(content, profileContext);
+    }
+    // ── Preparation ─────────────────────────────────────────────────────────────
+    /**
+     * Prepare one signal draft for creation admission.
+     *
+     * Fold recovery answers into the draft, then apply creation admission. A
+     * ready result authorizes final review; needs_revision returns admission
+     * feedback and a dynamic recovery form.
+     * @returns The admitted draft or repairable feedback and recovery fields.
+     * @throws On model failure; the host must expose a retryable failure.
+     *
+     * @param input - The payload and any recovery answers gathered so far.
+     */
+    async prepare(input) {
+        this.preparer ?? (this.preparer = new IntentPreparer(this.deps.agents?.verifier));
+        return this.preparer.invoke(input);
+    }
+    /**
+     * Measure text without applying any admission filters.
+     * @param content - The exact saved description.
+     * @param profileContext - The speaker's profile, serialized as JSON.
+     * @returns Metadata even when the verdict would fail admission.
+     * @throws On model failure; callers must leave the saved intent intact.
+     */
+    async scoreIntent(content, profileContext = "") {
+        return semanticMetadata(await this.verifyIntent(content, profileContext));
+    }
+    // ── Stateless surface ───────────────────────────────────────────────────────
+    /** Normalize explicit updates. Creation preserves the submitted description verbatim. */
+    static normalizeDescription(description) {
+        return normalizeIntentDescription(description);
+    }
+}

package/dist/capabilities/negotiations.d.ts

@@ -0,0 +1,17 @@
+import { type NegotiationTurn } from '../protocol/negotiation.rules.js';
+import type { NegotiationDatabase } from '../platform/database/negotiation.js';
+/** Autonomous participation: observe current rules, then commit a decision under those rules. */
+export declare class Negotiations {
+    private readonly database;
+    constructor(database: NegotiationDatabase);
+    /** @param id - Opportunity identity. @param userId - Reading principal. @returns Current guidance and legal actions, or null for an absent seat. */
+    observe(id: string, userId: string): Promise<{
+        guidance: string;
+        availableActions: import("../protocol/negotiation.rules.js").NegotiationAction[];
+        blockedReason: import("../protocol/negotiation.rules.js").NegotiationRejection | null;
+        maxTurns: number;
+        messageLimit: number;
+    } | null>;
+    /** @param id - Opportunity identity. @param userId - Acting principal. @param turn - Decision against an observed log. @returns The authoritative transition or refusal. */
+    execute(id: string, userId: string, turn: NegotiationTurn): Promise<import("../protocol/negotiation.rules.js").NegotiationDecision>;
+}

package/dist/capabilities/negotiations.js

@@ -0,0 +1,16 @@
+import { decideNegotiationTurn, observeNegotiation } from '../protocol/negotiation.rules.js';
+/** Autonomous participation: observe current rules, then commit a decision under those rules. */
+export class Negotiations {
+    constructor(database) {
+        this.database = database;
+    }
+    /** @param id - Opportunity identity. @param userId - Reading principal. @returns Current guidance and legal actions, or null for an absent seat. */
+    async observe(id, userId) {
+        const state = await this.database.readNegotiationState(id, userId);
+        return state ? observeNegotiation(state, userId) : null;
+    }
+    /** @param id - Opportunity identity. @param userId - Acting principal. @param turn - Decision against an observed log. @returns The authoritative transition or refusal. */
+    execute(id, userId, turn) {
+        return this.database.commitNegotiationTurn(id, userId, turn, (state) => decideNegotiationTurn(state, userId, turn));
+    }
+}

package/dist/{networks/network.module.d.ts → capabilities/networks.d.ts}

@@ -12,23 +12,17 @@
  *   indexer.graph        signal↔community assignment, direct or model-evaluated
  *   indexer.state        that graph's channel state
  *   network.recommender  ranking public communities during onboarding
- *   network.tools        the agent-facing tool definitions
  *
  * No directories: every stage here is one or two files, so a folder per stage
  * would only add a hop. Nothing outside `networks/` 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 { IntentNetworkGraphDatabase, NetworkGraphDatabase, NetworkMembershipGraphDatabase } from "../shared/interfaces/database.interface.js";
-import type { IntentNetworkIndexer } from "./indexer.graph.js";
-import type { NetworkToolDeps } from "./network.tools.js";
-export type { IntentNetworkIndexer, NetworkToolDeps };
+import type { IntentNetworkGraphDatabase, NetworkGraphDatabase, NetworkMembershipGraphDatabase } from "../platform/database.js";
 /**
  * Host capabilities the community graphs need.
  *
- * Both fields are optional so a host can construct `new Networks()` and reach
- * only {@link Networks.createTools}; each `create…Graph` method names the
- * dependency it requires.
+ * The field is optional so construction never fails; each `create…Graph`
+ * method names the dependency it requires.
  */
 export interface NetworksDeps {
     /**
@@ -37,11 +31,6 @@ export interface NetworksDeps {
      * query sets.
      */
     database?: NetworkGraphDatabase & NetworkMembershipGraphDatabase & IntentNetworkGraphDatabase;
-    /**
-     * Scores a signal against a community. Required by
-     * {@link Networks.createAssignmentGraph}; an `Intents` instance satisfies it.
-     */
-    indexer?: IntentNetworkIndexer;
 }
 /**
  * The networks capability.
@@ -61,7 +50,7 @@ export declare class Networks {
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         userId: string;
         networkId: string | undefined;
-        operationMode: "update" | "create" | "delete" | "read";
+        operationMode: "delete" | "update" | "create" | "read";
         createInput: {
             title: string;
             prompt?: string;
@@ -81,7 +70,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -120,7 +108,7 @@ export declare class Networks {
     }, {
         userId?: string | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-        operationMode?: "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read"> | undefined;
+        operationMode?: "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read"> | undefined;
         createInput?: {
             title: string;
             prompt?: string;
@@ -150,7 +138,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -183,7 +170,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -225,14 +211,14 @@ export declare class Networks {
             error?: string;
         } | undefined> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
-    }, "update" | "__start__" | "create" | "read" | "delete_idx", {
+    }, "update" | "create" | "read" | "__start__" | "delete_idx", {
         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>;
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        operationMode: import("@langchain/langgraph").BaseChannel<"update" | "create" | "delete" | "read", "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read">, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "update" | "create" | "read", "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read">, unknown>;
         createInput: import("@langchain/langgraph").BaseChannel<{
             title: string;
             prompt?: string;
@@ -272,7 +258,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -305,7 +290,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -338,7 +322,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -393,7 +376,7 @@ export declare class Networks {
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        operationMode: import("@langchain/langgraph").BaseChannel<"update" | "create" | "delete" | "read", "update" | "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"update" | "create" | "delete" | "read">, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "update" | "create" | "read", "delete" | "update" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "update" | "create" | "read">, unknown>;
         createInput: import("@langchain/langgraph").BaseChannel<{
             title: string;
             prompt?: string;
@@ -433,7 +416,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -466,7 +448,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -499,7 +480,6 @@ export declare class Networks {
                 title: string;
                 prompt: string | null;
                 autoAssign: boolean;
-                isPersonal: boolean;
                 joinedAt: Date;
             }>;
             owns: Array<{
@@ -555,7 +535,6 @@ export declare class Networks {
                     title: string;
                     prompt: string | null;
                     autoAssign: boolean;
-                    isPersonal: boolean;
                     joinedAt: Date;
                 }[];
                 owns: {
@@ -582,7 +561,6 @@ export declare class Networks {
                     title: string;
                     prompt: string | null;
                     autoAssign: boolean;
-                    isPersonal: boolean;
                     joinedAt: Date;
                 }[];
                 owns: {
@@ -673,7 +651,7 @@ export declare class Networks {
     createMembershipGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         userId: string;
         networkId: string;
-        operationMode: "create" | "delete" | "read";
+        operationMode: "delete" | "create" | "read";
         targetUserId: string | undefined;
         readResult: {
             networkId: string;
@@ -696,7 +674,7 @@ export declare class Networks {
     }, {
         userId?: string | undefined;
         networkId?: string | undefined;
-        operationMode?: "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read"> | undefined;
+        operationMode?: "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "read"> | undefined;
         targetUserId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         readResult?: {
             networkId: string;
@@ -742,7 +720,7 @@ export declare class Networks {
             (): import("@langchain/langgraph").LastValue<string>;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "read">, unknown>;
         targetUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         readResult: import("@langchain/langgraph").BaseChannel<{
             networkId: string;
@@ -803,7 +781,7 @@ export declare class Networks {
             (): import("@langchain/langgraph").LastValue<string>;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "read">, unknown>;
         targetUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         readResult: import("@langchain/langgraph").BaseChannel<{
             networkId: string;
@@ -908,26 +886,16 @@ export declare class Networks {
     }, unknown, unknown, []>;
     /**
      * Build the signal↔community assignment graph — link a signal to a community
-     * directly or after model evaluation, and unlink it.
+     * and unlink it.
      *
-     * @throws If the instance was constructed without a `database` or an `indexer`.
+     * @throws If the instance was constructed without a `database`.
      */
     createAssignmentGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         userId: string;
         networkId: string | undefined;
         intentId: string | undefined;
-        operationMode: "create" | "delete" | "read";
-        skipEvaluation: boolean;
-        intent: import("./indexer.state.js").IntentForIndexing | null;
-        indexContext: import("./indexer.state.js").IndexMemberContext | null;
-        evaluation: {
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | null;
-        shouldAssign: boolean | undefined;
-        finalScore: number | undefined;
-        assignmentResult: import("./indexer.state.js").AssignmentResult | null;
+        operationMode: "delete" | "create" | "read";
+        assignmentResult: import("../internal/networks/indexer.state.js").AssignmentResult | null;
         queryUserId: string | undefined;
         readResult: {
             links: Array<{
@@ -950,27 +918,13 @@ export declare class Networks {
             error?: string;
         } | undefined;
         error: string | null;
-        agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+        agentTimings: import("../index.js").DebugMetaAgent[];
     }, {
         userId?: string | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         intentId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
-        operationMode?: "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read"> | undefined;
-        skipEvaluation?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
-        intent?: import("./indexer.state.js").IntentForIndexing | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IntentForIndexing | null> | null | undefined;
-        indexContext?: import("./indexer.state.js").IndexMemberContext | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IndexMemberContext | null> | null | undefined;
-        evaluation?: {
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | import("@langchain/langgraph").OverwriteValue<{
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | null> | null | undefined;
-        shouldAssign?: boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined;
-        finalScore?: number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined;
-        assignmentResult?: import("./indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").AssignmentResult | null> | null | undefined;
+        operationMode?: "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "read"> | undefined;
+        assignmentResult?: import("../internal/networks/indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("../internal/networks/indexer.state.js").AssignmentResult | null> | null | undefined;
         queryUserId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         readResult?: {
             links: Array<{
@@ -1011,8 +965,8 @@ export declare class Networks {
             error?: string;
         } | undefined> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | null> | null | undefined;
-        agentTimings?: import("../chat/chat-streaming.types.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../chat/chat-streaming.types.js").DebugMetaAgent[]> | undefined;
-    }, "__start__" | "read" | "assign" | "unassign", {
+        agentTimings?: import("../index.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").DebugMetaAgent[]> | undefined;
+    }, "read" | "__start__" | "assign" | "unassign", {
         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>;
@@ -1020,26 +974,8 @@ export declare class Networks {
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         intentId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
-        skipEvaluation: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
-        intent: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IntentForIndexing | null, import("./indexer.state.js").IntentForIndexing | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IntentForIndexing | null> | null, unknown>;
-        indexContext: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IndexMemberContext | null, import("./indexer.state.js").IndexMemberContext | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IndexMemberContext | null> | null, unknown>;
-        evaluation: import("@langchain/langgraph").BaseChannel<{
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | null, {
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | import("@langchain/langgraph").OverwriteValue<{
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | null> | null, unknown>;
-        shouldAssign: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
-        finalScore: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
-        assignmentResult: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").AssignmentResult | null, import("./indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").AssignmentResult | null> | null, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "read">, unknown>;
+        assignmentResult: import("@langchain/langgraph").BaseChannel<import("../internal/networks/indexer.state.js").AssignmentResult | null, import("../internal/networks/indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("../internal/networks/indexer.state.js").AssignmentResult | null> | null, unknown>;
         queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         readResult: import("@langchain/langgraph").BaseChannel<{
             links: Array<{
@@ -1098,7 +1034,7 @@ export declare class Networks {
             error?: string;
         } | undefined> | undefined, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, 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>;
+        agentTimings: import("@langchain/langgraph").BaseChannel<import("../index.js").DebugMetaAgent[], import("../index.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").DebugMetaAgent[]>, unknown>;
     }, {
         userId: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
@@ -1107,26 +1043,8 @@ export declare class Networks {
         };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         intentId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
-        operationMode: import("@langchain/langgraph").BaseChannel<"create" | "delete" | "read", "create" | "delete" | "read" | import("@langchain/langgraph").OverwriteValue<"create" | "delete" | "read">, unknown>;
-        skipEvaluation: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
-        intent: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IntentForIndexing | null, import("./indexer.state.js").IntentForIndexing | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IntentForIndexing | null> | null, unknown>;
-        indexContext: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").IndexMemberContext | null, import("./indexer.state.js").IndexMemberContext | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").IndexMemberContext | null> | null, unknown>;
-        evaluation: import("@langchain/langgraph").BaseChannel<{
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | null, {
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | import("@langchain/langgraph").OverwriteValue<{
-            reasoning: string;
-            indexScore: number;
-            memberScore: number;
-        } | null> | null, unknown>;
-        shouldAssign: import("@langchain/langgraph").BaseChannel<boolean | undefined, boolean | import("@langchain/langgraph").OverwriteValue<boolean | undefined> | undefined, unknown>;
-        finalScore: import("@langchain/langgraph").BaseChannel<number | undefined, number | import("@langchain/langgraph").OverwriteValue<number | undefined> | undefined, unknown>;
-        assignmentResult: import("@langchain/langgraph").BaseChannel<import("./indexer.state.js").AssignmentResult | null, import("./indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("./indexer.state.js").AssignmentResult | null> | null, unknown>;
+        operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "create" | "read", "delete" | "create" | "read" | import("@langchain/langgraph").OverwriteValue<"delete" | "create" | "read">, unknown>;
+        assignmentResult: import("@langchain/langgraph").BaseChannel<import("../internal/networks/indexer.state.js").AssignmentResult | null, import("../internal/networks/indexer.state.js").AssignmentResult | import("@langchain/langgraph").OverwriteValue<import("../internal/networks/indexer.state.js").AssignmentResult | null> | null, unknown>;
         queryUserId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         readResult: import("@langchain/langgraph").BaseChannel<{
             links: Array<{
@@ -1185,90 +1103,38 @@ export declare class Networks {
             error?: string;
         } | undefined> | undefined, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | null, string | import("@langchain/langgraph").OverwriteValue<string | null> | null, 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>;
+        agentTimings: import("@langchain/langgraph").BaseChannel<import("../index.js").DebugMetaAgent[], import("../index.js").DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<import("../index.js").DebugMetaAgent[]>, unknown>;
     }, import("@langchain/langgraph").StateDefinition, {
         assign: {
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            agentTimings: import("../index.js").DebugMetaAgent[];
             mutationResult: {
                 success: boolean;
                 error: string;
                 message?: undefined;
             };
-            evaluation?: undefined;
-            shouldAssign?: undefined;
-            finalScore?: undefined;
         } | {
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
+            agentTimings: import("../index.js").DebugMetaAgent[];
             mutationResult: {
                 success: boolean;
                 message: string;
                 error?: undefined;
             };
-            evaluation?: undefined;
-            shouldAssign?: undefined;
-            finalScore?: undefined;
-        } | {
-            assignmentResult: import("./indexer.state.js").AssignmentResult;
-            mutationResult: {
-                success: boolean;
-                message: string;
-                error?: undefined;
-            };
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
-            evaluation?: undefined;
-            shouldAssign?: undefined;
-            finalScore?: undefined;
-        } | {
-            assignmentResult: import("./indexer.state.js").AssignmentResult;
-            mutationResult: {
-                success: boolean;
-                error: string;
-                message?: undefined;
-            };
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
-            evaluation?: undefined;
-            shouldAssign?: undefined;
-            finalScore?: undefined;
         } | {
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
-            evaluation: null;
-            shouldAssign: boolean;
-            finalScore: number;
-            mutationResult: {
-                success: boolean;
-                error: string;
-                message?: undefined;
-            };
-        } | {
-            assignmentResult: import("./indexer.state.js").AssignmentResult;
+            assignmentResult: import("../internal/networks/indexer.state.js").AssignmentResult;
             mutationResult: {
                 success: boolean;
                 message: string;
                 error?: undefined;
             };
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
-            evaluation: {
-                reasoning: string;
-                indexScore: number;
-                memberScore: number;
-            };
-            shouldAssign: boolean;
-            finalScore: number;
+            agentTimings: import("../index.js").DebugMetaAgent[];
         } | {
-            assignmentResult: import("./indexer.state.js").AssignmentResult;
+            assignmentResult: import("../internal/networks/indexer.state.js").AssignmentResult;
             mutationResult: {
                 success: boolean;
                 error: string;
                 message?: undefined;
             };
-            agentTimings: import("../chat/chat-streaming.types.js").DebugMetaAgent[];
-            evaluation: {
-                reasoning: string;
-                indexScore: number;
-                memberScore: number;
-            };
-            shouldAssign: boolean;
-            finalScore: number;
+            agentTimings: import("../index.js").DebugMetaAgent[];
         };
         read: {
             readResult: {
@@ -1307,8 +1173,6 @@ export declare class Networks {
             };
         };
     }, unknown, unknown, []>;
-    /** Register the agent-facing community tools against a tool definer. */
-    static createTools(defineTool: DefineTool, deps: NetworkToolDeps): readonly [any, any, any, any, any, any, any];
     /** The database, or the error naming the method that needed it. */
     private database;
 }

package/dist/{networks/network.module.js → capabilities/networks.js}

@@ -12,16 +12,14 @@
  *   indexer.graph        signal↔community assignment, direct or model-evaluated
  *   indexer.state        that graph's channel state
  *   network.recommender  ranking public communities during onboarding
- *   network.tools        the agent-facing tool definitions
  *
  * No directories: every stage here is one or two files, so a folder per stage
  * would only add a hop. Nothing outside `networks/` imports any of it; the
  * layout may change freely as long as this class keeps its shape.
  */
-import { IntentNetworkGraphFactory } from "./indexer.graph.js";
-import { NetworkMembershipGraphFactory } from "./membership.graph.js";
-import { NetworkGraphFactory } from "./network.graph.js";
-import { createNetworkTools } from "./network.tools.js";
+import { IntentNetworkGraphFactory } from "../internal/networks/indexer.graph.js";
+import { NetworkMembershipGraphFactory } from "../internal/networks/membership.graph.js";
+import { NetworkGraphFactory } from "../internal/networks/network.graph.js";
 /**
  * The networks capability.
  *
@@ -55,21 +53,12 @@ export class Networks {
     // ── Signal assignment ───────────────────────────────────────────────────────
     /**
      * Build the signal↔community assignment graph — link a signal to a community
-     * directly or after model evaluation, and unlink it.
+     * and unlink it.
      *
-     * @throws If the instance was constructed without a `database` or an `indexer`.
+     * @throws If the instance was constructed without a `database`.
      */
     createAssignmentGraph() {
-        const { indexer } = this.deps;
-        if (!indexer) {
-            throw new Error("Networks.createAssignmentGraph() requires an `indexer` dependency.");
-        }
-        return new IntentNetworkGraphFactory(this.database("createAssignmentGraph"), indexer).createGraph();
-    }
-    // ── Stateless surface ───────────────────────────────────────────────────────
-    /** Register the agent-facing community tools against a tool definer. */
-    static createTools(defineTool, deps) {
-        return createNetworkTools(defineTool, deps);
+        return new IntentNetworkGraphFactory(this.database("createAssignmentGraph")).createGraph();
     }
     // ── Internals ───────────────────────────────────────────────────────────────
     /** The database, or the error naming the method that needed it. */