@indexnetwork/protocol 6.12.1-rc.404.1 → 6.13.22-rc.405.1

package/dist/capabilities/signals.indexing.facade.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Narrow signals port previously consumed by communities/network to rank
+ * signal membership.  Re-exports from the canonical signals facade to avoid
+ * the legacy intent/ shim path.
+ *
+ * IND-546: canonical import path changed from intent/intent.indexer to
+ * capabilities/signals.facade (which exports from signals/application).
+ * communities/ports/index.ts is now the primary consumer; this file is
+ * retained for any lingering direct importers during the transition.
+ */
+export { IntentIndexer } from "./signals.facade.js";
+export type { IntentIndexerOutput } from "./signals.facade.js";

package/dist/capabilities/signals.indexing.facade.js

@@ -0,0 +1,11 @@
+/**
+ * Narrow signals port previously consumed by communities/network to rank
+ * signal membership.  Re-exports from the canonical signals facade to avoid
+ * the legacy intent/ shim path.
+ *
+ * IND-546: canonical import path changed from intent/intent.indexer to
+ * capabilities/signals.facade (which exports from signals/application).
+ * communities/ports/index.ts is now the primary consumer; this file is
+ * retained for any lingering direct importers during the transition.
+ */
+export { IntentIndexer } from "./signals.facade.js";

package/dist/capabilities/signals.tools.port.d.ts

@@ -0,0 +1,5 @@
+import type { ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
+/** Host capabilities consumed by signal and intent tools. */
+export type IntentToolDeps = Pick<ToolRegistryCompositionDeps, "userDb" | "systemDb"> & {
+    graphs: Pick<ToolRegistryCompositionDeps["graphs"], "intent" | "intentIndex" | "profile">;
+};

package/dist/capabilities/signals.tools.port.js

@@ -0,0 +1 @@
+export {};

package/dist/chat/chat-streaming.types.d.ts

@@ -662,4 +662,3 @@ export declare function createUserQuestionEvent(sessionId: string, payload: {
  * Creates a steer-or-queue event injected into the active stream by the interrupt endpoint.
  */
 export declare function createSteerOrQueueEvent(sessionId: string, decision: "steer" | "queue", messageId: string): SteerOrQueueEvent;
-//# sourceMappingURL=chat-streaming.types.d.ts.map

package/dist/chat/chat-streaming.types.js

@@ -15,7 +15,7 @@ export function formatSSEEvent(event) {
     try {
         return `data: ${JSON.stringify(event)}\n\n`;
     }
-    catch (serializeError) {
+    catch {
         const fallback = {
             type: "error",
             sessionId: typeof event.sessionId === "string"
@@ -305,4 +305,3 @@ export function createSteerOrQueueEvent(sessionId, decision, messageId) {
         messageId,
     });
 }
-//# sourceMappingURL=chat-streaming.types.js.map

package/dist/chat/chat.agent.d.ts

@@ -341,4 +341,3 @@ export declare class ChatAgent {
         };
     }>;
 }
-//# sourceMappingURL=chat.agent.d.ts.map

package/dist/chat/chat.agent.js

@@ -1207,4 +1207,3 @@ __decorate([
     __metadata("design:paramtypes", [Array, Function, AbortSignal]),
     __metadata("design:returntype", Promise)
 ], ChatAgent.prototype, "streamRun", null);
-//# sourceMappingURL=chat.agent.js.map

package/dist/chat/chat.graph.d.ts

@@ -384,4 +384,3 @@ export declare class ChatGraphFactory {
      */
     private buildGraph;
 }
-//# sourceMappingURL=chat.graph.d.ts.map

package/dist/chat/chat.graph.js

@@ -275,4 +275,3 @@ export class ChatGraphFactory {
         return workflow;
     }
 }
-//# sourceMappingURL=chat.graph.js.map

package/dist/chat/chat.interrupt.classifier.d.ts

@@ -23,4 +23,3 @@ export declare class ChatInterruptClassifier {
      */
     classify(input: ClassifyInterruptInput): Promise<"steer" | "queue">;
 }
-//# sourceMappingURL=chat.interrupt.classifier.d.ts.map

package/dist/chat/chat.interrupt.classifier.js

@@ -62,4 +62,3 @@ __decorate([
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], ChatInterruptClassifier.prototype, "classify", null);
-//# sourceMappingURL=chat.interrupt.classifier.js.map

package/dist/chat/chat.persona.d.ts

@@ -58,4 +58,3 @@ export declare const ORCHESTRATOR_PERSONA_ID = "orchestrator";
  * version was loaded first.
  */
 export declare const ORCHESTRATOR_PERSONA: ChatPersonaConfig;
-//# sourceMappingURL=chat.persona.d.ts.map

package/dist/chat/chat.persona.js

@@ -23,4 +23,3 @@ export const ORCHESTRATOR_PERSONA = {
         hallucinationRecovery: true,
     },
 };
-//# sourceMappingURL=chat.persona.js.map

package/dist/chat/chat.prompt.d.ts

@@ -15,4 +15,3 @@ export declare const ITERATION_NUDGE = "[System Note: You've made several tool c
  * @returns The complete system prompt string
  */
 export declare function buildSystemContent(ctx: ResolvedToolContext, iterCtx?: IterationContext): string;
-//# sourceMappingURL=chat.prompt.d.ts.map

package/dist/chat/chat.prompt.js

@@ -430,4 +430,3 @@ export function buildSystemContent(ctx, iterCtx) {
     const modules = iterCtx ? resolveModules(iterCtx) : "";
     return buildCoreHead(ctx) + buildOnboarding(ctx) + buildCoreBody(ctx) + modules + buildScoping(ctx) + buildCoreTail(ctx);
 }
-//# sourceMappingURL=chat.prompt.js.map

package/dist/chat/chat.prompt.modules.d.ts

@@ -60,4 +60,3 @@ export declare const PROMPT_MODULES: PromptModule[];
  * @returns Concatenated prompt text from all matched modules
  */
 export declare function resolveModules(iterCtx: IterationContext): string;
-//# sourceMappingURL=chat.prompt.modules.d.ts.map

package/dist/chat/chat.prompt.modules.js

@@ -375,4 +375,3 @@ export function resolveModules(iterCtx) {
     }
     return sections.join("\n");
 }
-//# sourceMappingURL=chat.prompt.modules.js.map

package/dist/chat/chat.question-dedup.d.ts

@@ -12,4 +12,3 @@ export declare function deduplicateQuestions<T extends QuestionLike>(questions:
     newIds: string[];
 };
 export {};
-//# sourceMappingURL=chat.question-dedup.d.ts.map

package/dist/chat/chat.question-dedup.js

@@ -15,4 +15,3 @@ export function deduplicateQuestions(questions, surfacedIds) {
     }
     return { fresh, newIds };
 }
-//# sourceMappingURL=chat.question-dedup.js.map

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

@@ -133,4 +133,3 @@ export declare const ChatGraphState: import("@langchain/langgraph").AnnotationRo
  * Use this for typing node functions and graph invocations.
  */
 export type ChatGraphStateType = typeof ChatGraphState.State;
-//# sourceMappingURL=chat.state.d.ts.map

package/dist/chat/chat.state.js

@@ -118,4 +118,3 @@ export const ChatGraphState = Annotation.Root({
         default: () => undefined,
     }),
 });
-//# sourceMappingURL=chat.state.js.map

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

@@ -62,4 +62,3 @@ export declare class ChatStreamer {
         scopeId?: string;
     }, sessionId: string, checkpointer?: BaseCheckpointSaver, signal?: AbortSignal, threadId?: string): AsyncGenerator<ChatStreamEvent>;
 }
-//# sourceMappingURL=chat.streamer.d.ts.map

package/dist/chat/chat.streamer.js

@@ -224,4 +224,3 @@ export class ChatStreamer {
         }
     }
 }
-//# sourceMappingURL=chat.streamer.js.map

package/dist/chat/chat.suggester.d.ts

@@ -21,4 +21,3 @@ export declare class SuggestionGenerator {
      */
     generate(input: SuggestionGeneratorInput): Promise<ChatSuggestion[]>;
 }
-//# sourceMappingURL=chat.suggester.d.ts.map

package/dist/chat/chat.suggester.js

@@ -93,4 +93,3 @@ __decorate([
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], SuggestionGenerator.prototype, "generate", null);
-//# sourceMappingURL=chat.suggester.js.map

package/dist/chat/chat.summarizer.d.ts

@@ -18,4 +18,3 @@ export declare class ChatSummarizer {
      */
     summarize(input: ChatSummarizerInput): Promise<ChatContextDigest | null>;
 }
-//# sourceMappingURL=chat.summarizer.d.ts.map

package/dist/chat/chat.summarizer.js

@@ -95,4 +95,3 @@ __decorate([
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], ChatSummarizer.prototype, "summarize", null);
-//# sourceMappingURL=chat.summarizer.js.map

package/dist/chat/chat.title.generator.d.ts

@@ -17,4 +17,3 @@ export declare class ChatTitleGenerator {
      */
     invoke(input: TitleGeneratorInput): Promise<string>;
 }
-//# sourceMappingURL=chat.title.generator.d.ts.map

package/dist/chat/chat.title.generator.js

@@ -64,4 +64,3 @@ __decorate([
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], ChatTitleGenerator.prototype, "invoke", null);
-//# sourceMappingURL=chat.title.generator.js.map

package/dist/chat/chat.tools.d.ts

@@ -3,4 +3,3 @@ export declare function createChatTools(defineTool: DefineTool, deps: ToolDeps):
     listConversations: any;
     getConversation: any;
 };
-//# sourceMappingURL=chat.tools.d.ts.map

package/dist/chat/chat.tools.js

@@ -56,4 +56,3 @@ export function createChatTools(defineTool, deps) {
     });
     return { listConversations, getConversation };
 }
-//# sourceMappingURL=chat.tools.js.map

package/dist/chat/chat.utils.d.ts

@@ -39,4 +39,3 @@ export declare function estimateMessageTokens(message: BaseMessage): number;
  * @returns Array of messages that fit within the token limit
  */
 export declare function truncateToTokenLimit(messages: BaseMessage[], maxTokens?: number): BaseMessage[];
-//# sourceMappingURL=chat.utils.d.ts.map

package/dist/chat/chat.utils.js

@@ -86,4 +86,3 @@ export function truncateToTokenLimit(messages, maxTokens = MAX_CONTEXT_TOKENS) {
     // Combine system message (if any) with recent messages
     return hasSystemMessage ? [firstMessage, ...recentMessages] : recentMessages;
 }
-//# sourceMappingURL=chat.utils.js.map

package/dist/chat/negotiator.persona.d.ts

@@ -72,4 +72,3 @@ export declare function createNegotiatorTools(deps: ToolContext, preResolvedCont
  * @param opts - Identity from the user's `type='personal'` agent row
  */
 export declare function createNegotiatorPersona(opts: NegotiatorPromptOptions): ChatPersonaConfig;
-//# sourceMappingURL=negotiator.persona.d.ts.map

package/dist/chat/negotiator.persona.js

@@ -163,4 +163,3 @@ export function createNegotiatorPersona(opts) {
         },
     };
 }
-//# sourceMappingURL=negotiator.persona.js.map

package/dist/chat/negotiator.prompt.d.ts

@@ -1,5 +1,5 @@
 import type { ResolvedToolContext } from "../shared/agent/tool.factory.js";
-import { type NegotiatorMemoryEntry } from "../negotiation/negotiation.memory.js";
+import { type NegotiatorMemoryEntry } from "../capabilities/negotiation.memory.facade.js";
 import type { IterationContext } from "./chat.prompt.modules.js";
 /** Identity options resolved from the user's personal negotiator agent row. */
 export interface NegotiatorPromptOptions {
@@ -43,4 +43,3 @@ export interface NegotiatorPromptOptions {
  * @returns The complete system prompt string
  */
 export declare function buildNegotiatorSystemContent(ctx: ResolvedToolContext, opts: NegotiatorPromptOptions, _iterCtx?: IterationContext): string;
-//# sourceMappingURL=negotiator.prompt.d.ts.map

package/dist/chat/negotiator.prompt.js

@@ -1,5 +1,5 @@
 import { focusedIntentId } from "../shared/agent/tool.scope.js";
-import { renderNegotiatorChatMemorySection } from "../negotiation/negotiation.memory.js";
+import { renderNegotiatorChatMemorySection } from "../capabilities/negotiation.memory.facade.js";
 /**
  * Renders the pinned-signal section for intent-scoped sessions (P4.2).
  * Awareness, not a sandbox: the conversation orbits this signal, but the
@@ -154,4 +154,3 @@ ${profileContext}
 - **Voice**: first person, loyal but candid, calm and concise. No hype, no networking clichés, no exaggeration. You are their agent, not a salesperson.
 - When calling tools, first write a short natural sentence plus a \`>\` blockquote describing what you are checking (e.g. "> Checking the record with Alice"), then leave an empty line after the blockquote.`;
 }
-//# sourceMappingURL=negotiator.prompt.js.map

package/dist/chat/negotiator.tools.d.ts

@@ -40,4 +40,3 @@ export declare function createNegotiatorMemoryTools(opts: {
     description?: string | undefined;
     memoryId?: string | undefined;
 }, string, unknown, "forget">)[];
-//# sourceMappingURL=negotiator.tools.d.ts.map

package/dist/chat/negotiator.tools.js

@@ -132,4 +132,3 @@ export function createNegotiatorMemoryTools(opts) {
     });
     return [remember, forget];
 }
-//# sourceMappingURL=negotiator.tools.js.map

package/dist/chat/onboarding.persona.d.ts

@@ -27,4 +27,3 @@ export declare function narrowOnboardingTools(allowed: ChatTools): ChatTools;
 export declare function createOnboardingTools(deps: ToolContext, preResolvedContext?: ResolvedToolContext): Promise<ChatTools>;
 /** Restricted web onboarding persona on the persona-neutral chat runtime. */
 export declare const ONBOARDING_PERSONA: ChatPersonaConfig;
-//# sourceMappingURL=onboarding.persona.d.ts.map

package/dist/chat/onboarding.persona.js

@@ -99,4 +99,3 @@ export const ONBOARDING_PERSONA = {
         hallucinationRecovery: true,
     },
 };
-//# sourceMappingURL=onboarding.persona.js.map

package/dist/chat/onboarding.prompt.d.ts

@@ -4,4 +4,3 @@ import type { IterationContext } from "./chat.prompt.modules.js";
 export declare const ONBOARDING_PROFILE_KICKOFF = "onboarding-profile-kickoff";
 /** Builds the restricted, server-selected web onboarding prompt. */
 export declare function buildOnboardingSystemContent(ctx: ResolvedToolContext, iterCtx?: IterationContext): string;
-//# sourceMappingURL=onboarding.prompt.d.ts.map

package/dist/chat/onboarding.prompt.js

@@ -71,4 +71,3 @@ ${membershipContext}
 
 ${phaseGuidance}`;
 }
-//# sourceMappingURL=onboarding.prompt.js.map

package/dist/chat/reporter.action.contracts.d.ts

@@ -0,0 +1,36 @@
+export type AgentCleanupActionType = "retract_premise" | "narrow_signal" | "pause_signal";
+export interface AgentActionProposalSnapshot {
+    status: string;
+    updatedAt?: string;
+    payload?: string;
+    summary?: string | null;
+    assertionText?: string;
+}
+interface AgentActionProposalActionBase {
+    entityId: string;
+    currentState: string;
+    proposedOperation: string;
+    evidence?: string;
+    skipped?: boolean;
+    reason?: string;
+    snapshot?: AgentActionProposalSnapshot;
+    description?: string;
+}
+export type AgentActionProposalAction = (AgentActionProposalActionBase & {
+    type: "retract_premise";
+}) | (AgentActionProposalActionBase & {
+    type: "narrow_signal";
+}) | (AgentActionProposalActionBase & {
+    type: "pause_signal";
+});
+export interface AgentActionProposal {
+    proposalId: string;
+    userId: string;
+    conversationId?: string;
+    actions: AgentActionProposalAction[];
+}
+/** Host persistence bridge for proposals; the reporter tool never mutates domain rows. */
+export interface AgentActionProposalStore {
+    createProposal(proposal: AgentActionProposal): Promise<void>;
+}
+export {};

package/dist/chat/reporter.action.contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/chat/reporter.action.tools.d.ts

@@ -1,41 +1,8 @@
 import type { ChatGraphCompositeDatabase, UserDatabase } from "../shared/interfaces/database.interface.js";
 import type { ChatTools, ResolvedToolContext, ToolContext } from "../shared/agent/tool.factory.js";
+import type { AgentActionProposalStore } from "./reporter.action.contracts.js";
+export type { AgentActionProposal, AgentActionProposalAction, AgentActionProposalSnapshot, AgentActionProposalStore, AgentCleanupActionType, } from "./reporter.action.contracts.js";
 export declare const AGENT_ACTION_PROPOSAL_FENCE = "agent_action_proposal";
-export type AgentCleanupActionType = "retract_premise" | "narrow_signal" | "pause_signal";
-export interface AgentActionProposalSnapshot {
-    status: string;
-    updatedAt?: string;
-    payload?: string;
-    summary?: string | null;
-    assertionText?: string;
-}
-interface AgentActionProposalActionBase {
-    entityId: string;
-    currentState: string;
-    proposedOperation: string;
-    evidence?: string;
-    skipped?: boolean;
-    reason?: string;
-    snapshot?: AgentActionProposalSnapshot;
-    description?: string;
-}
-export type AgentActionProposalAction = (AgentActionProposalActionBase & {
-    type: "retract_premise";
-}) | (AgentActionProposalActionBase & {
-    type: "narrow_signal";
-}) | (AgentActionProposalActionBase & {
-    type: "pause_signal";
-});
-export interface AgentActionProposal {
-    proposalId: string;
-    userId: string;
-    conversationId?: string;
-    actions: AgentActionProposalAction[];
-}
-/** Host persistence bridge for proposals; the reporter tool never mutates domain rows. */
-export interface AgentActionProposalStore {
-    createProposal(proposal: AgentActionProposal): Promise<void>;
-}
 /**
  * Creates the reporter-only proposal tool. It validates owner state and records
  * snapshots, but intentionally has no mutation dependency.
@@ -48,5 +15,3 @@ export declare function createProposeCleanupActionsTool(input: {
 }): ChatTools[number];
 /** Build the optional action tool from the host-provided ToolContext. */
 export declare function createReporterActionTool(deps: ToolContext, context: ResolvedToolContext, userDb: UserDatabase): ChatTools[number] | null;
-export {};
-//# sourceMappingURL=reporter.action.tools.d.ts.map

package/dist/chat/reporter.action.tools.js

@@ -143,4 +143,3 @@ export function createReporterActionTool(deps, context, userDb) {
         store: deps.actionProposalStore,
     });
 }
-//# sourceMappingURL=reporter.action.tools.js.map

package/dist/chat/reporter.persona.d.ts

@@ -29,4 +29,3 @@ export declare function narrowReporterTools(allowed: ChatTools, boundary: Report
 export declare function createReporterTools(deps: ToolContext, preResolvedContext?: ResolvedToolContext): Promise<ChatTools>;
 /** Restricted read-only Agent reporter persona. */
 export declare const REPORTER_PERSONA: ChatPersonaConfig;
-//# sourceMappingURL=reporter.persona.d.ts.map

package/dist/chat/reporter.persona.js

@@ -207,4 +207,3 @@ export const REPORTER_PERSONA = {
         hallucinationRecovery: false,
     },
 };
-//# sourceMappingURL=reporter.persona.js.map

package/dist/chat/reporter.prompt.d.ts

@@ -22,4 +22,3 @@ export declare function resolveReporterDeterministicResponse(iterCtx: IterationC
  * @returns Complete reporter system content
  */
 export declare function buildReporterSystemContent(ctx: ResolvedToolContext, iterCtx?: IterationContext): string;
-//# sourceMappingURL=reporter.prompt.d.ts.map

package/dist/chat/reporter.prompt.js

@@ -147,4 +147,3 @@ ${membershipContext}
 
 Only the identity, context, and membership metadata above are preloaded. Signals, premises, questions, and activity are not preloaded: call the appropriate read/report tool before describing them.${buildTurnGuidance(iterCtx)}${buildBriefingGuidance(iterCtx)}`;
 }
-//# sourceMappingURL=reporter.prompt.js.map

package/dist/chat/signal.persona.d.ts

@@ -45,4 +45,3 @@ export declare function narrowSignalTools(allowed: ChatTools, boundary: SignalTo
 export declare function createSignalTools(deps: ToolContext, preResolvedContext?: ResolvedToolContext): Promise<ChatTools>;
 /** Restricted Signal Agent persona on the persona-neutral chat runtime. */
 export declare const SIGNAL_PERSONA: ChatPersonaConfig;
-//# sourceMappingURL=signal.persona.d.ts.map

package/dist/chat/signal.persona.js

@@ -320,4 +320,3 @@ export const SIGNAL_PERSONA = {
         hallucinationRecovery: true,
     },
 };
-//# sourceMappingURL=signal.persona.js.map

package/dist/chat/signal.prompt.d.ts

@@ -36,4 +36,3 @@ export declare function buildSignalIntakeGuidance(stage: SignalIntakeStage | nul
  * @returns The complete Signal Agent system prompt
  */
 export declare function buildSignalSystemContent(ctx: ResolvedToolContext, iterCtx?: IterationContext): string;
-//# sourceMappingURL=signal.prompt.d.ts.map

package/dist/chat/signal.prompt.js

@@ -153,4 +153,3 @@ ${membershipContext}
 
 Only the identity, profile, and current membership context above are preloaded. Ground every claim about signals, placements, memberships, or premises in a tool result from this conversation. When calling a tool, briefly tell the user what you are checking or changing, then perform the call.${buildSignalIntakeGuidance(getSignalIntakeStage(iterCtx))}`;
 }
-//# sourceMappingURL=signal.prompt.js.map

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

@@ -0,0 +1,45 @@
+/**
+ * communities/application — orchestrators, factories, tools, and agents.
+ *
+ * Re-exports the orchestration tier of the communities capability: graph
+ * factories (LangGraph compilations), tool factories, and agent classes.
+ *
+ * Boundary: application-layer only.  Imports from communities/domain,
+ * communities/ports, and shared/ infrastructure — never from runtime/,
+ * host implementations, or capability facades (except as injected ports).
+ *
+ * ## Foreground use cases (participant-directed)
+ *
+ * - {@link NetworkGraphFactory} — compiles the network lifecycle graph
+ *   (create, read, update, delete networks).
+ * - {@link NetworkMembershipGraphFactory} — compiles the membership graph
+ *   (add, list, remove members; enforces join-policy and owner authority).
+ * - {@link IntentNetworkGraphFactory} — compiles the signal assignment graph
+ *   (direct or LLM-evaluated intent–network linking; unassign).
+ *   IntentIndexer is injected from the signals public facade.
+ * - {@link createNetworkTools} — foreground tool factory; accepts compiled graphs
+ *   and host deps through communities.tools.port and produces LangChain-compatible
+ *   tool arrays for the tool registry.
+ *
+ * ## Ambient use case (ranking / recommendation)
+ *
+ * - {@link NetworkRecommender} — LLM-based community ranking used during onboarding
+ *   (step 6) to surface the most relevant public communities for a user.  Lazy-
+ *   instantiated inside createNetworkTools to avoid requiring OPENROUTER_API_KEY
+ *   at import time.
+ *
+ * ## Application-internal (not in public surface)
+ *
+ * - {@link IntentNetworkGraphState}, {@link AssignmentResult}, etc. — graph execution
+ *   state types used within indexer.graph.ts; available here for consumers that
+ *   need the application-layer state shape.
+ *
+ * IND-546: canonical application home for communities capability previously spread
+ * across network/, network/membership/, and network/indexer/.
+ */
+export { NetworkGraphFactory } from "./network.graph.js";
+export { NetworkMembershipGraphFactory } from "./membership.graph.js";
+export { IntentNetworkGraphFactory } from "./indexer.graph.js";
+export { IntentNetworkGraphState, type AssignmentResult, type IntentForIndexing, type IndexMemberContext, } from "./indexer.state.js";
+export { NetworkRecommender, NetworkRecommenderOutputSchema, type NetworkRecommenderOutput, type NetworkRecommenderInput, type NetworkRecommenderNetwork, } from "./network.recommender.js";
+export { createNetworkTools } from "./network.tools.js";

package/dist/communities/application/index.js

@@ -0,0 +1,50 @@
+/**
+ * communities/application — orchestrators, factories, tools, and agents.
+ *
+ * Re-exports the orchestration tier of the communities capability: graph
+ * factories (LangGraph compilations), tool factories, and agent classes.
+ *
+ * Boundary: application-layer only.  Imports from communities/domain,
+ * communities/ports, and shared/ infrastructure — never from runtime/,
+ * host implementations, or capability facades (except as injected ports).
+ *
+ * ## Foreground use cases (participant-directed)
+ *
+ * - {@link NetworkGraphFactory} — compiles the network lifecycle graph
+ *   (create, read, update, delete networks).
+ * - {@link NetworkMembershipGraphFactory} — compiles the membership graph
+ *   (add, list, remove members; enforces join-policy and owner authority).
+ * - {@link IntentNetworkGraphFactory} — compiles the signal assignment graph
+ *   (direct or LLM-evaluated intent–network linking; unassign).
+ *   IntentIndexer is injected from the signals public facade.
+ * - {@link createNetworkTools} — foreground tool factory; accepts compiled graphs
+ *   and host deps through communities.tools.port and produces LangChain-compatible
+ *   tool arrays for the tool registry.
+ *
+ * ## Ambient use case (ranking / recommendation)
+ *
+ * - {@link NetworkRecommender} — LLM-based community ranking used during onboarding
+ *   (step 6) to surface the most relevant public communities for a user.  Lazy-
+ *   instantiated inside createNetworkTools to avoid requiring OPENROUTER_API_KEY
+ *   at import time.
+ *
+ * ## Application-internal (not in public surface)
+ *
+ * - {@link IntentNetworkGraphState}, {@link AssignmentResult}, etc. — graph execution
+ *   state types used within indexer.graph.ts; available here for consumers that
+ *   need the application-layer state shape.
+ *
+ * IND-546: canonical application home for communities capability previously spread
+ * across network/, network/membership/, and network/indexer/.
+ */
+// ── Network lifecycle graph ───────────────────────────────────────────────────
+export { NetworkGraphFactory } from "./network.graph.js";
+// ── Membership graph ──────────────────────────────────────────────────────────
+export { NetworkMembershipGraphFactory } from "./membership.graph.js";
+// ── Signal-assignment (indexer) graph + state ─────────────────────────────────
+export { IntentNetworkGraphFactory } from "./indexer.graph.js";
+export { IntentNetworkGraphState, } from "./indexer.state.js";
+// ── Community ranking agent ───────────────────────────────────────────────────
+export { NetworkRecommender, NetworkRecommenderOutputSchema, } from "./network.recommender.js";
+// ── Tool factory (foreground adapter entry point) ─────────────────────────────
+export { createNetworkTools } from "./network.tools.js";