@indexnetwork/protocol 6.12.1-rc.404.1 → 6.14.0-rc.406.1

package/dist/shared/agent/tool.factory.js

@@ -1,228 +1,6 @@
-import { tool } from "@langchain/core/tools";
-import { IntentGraphFactory } from "../../intent/intent.graph.js";
-import { EnrichmentGraphFactory } from "../../enrichment/enrichment.graph.js";
-import { OpportunityGraphFactory } from "../../opportunity/opportunity.graph.js";
-import { HydeGraphFactory } from "../hyde/hyde.graph.js";
-import { HydeGenerator } from "../hyde/hyde.generator.js";
-import { LensInferrer } from "../hyde/lens.inferrer.js";
-import { NetworkGraphFactory } from "../../network/network.graph.js";
-import { NetworkMembershipGraphFactory } from "../../network/membership/membership.graph.js";
-import { IntentNetworkGraphFactory } from "../../network/indexer/indexer.graph.js";
-import { IntentIndexer } from "../../intent/intent.indexer.js";
-import { NegotiationGraphFactory } from "../../negotiation/negotiation.graph.js";
-import { PremiseGraphFactory } from "../../premise/premise.graph.js";
-import { protocolLogger } from "../observability/protocol.logger.js";
-import { resolveChatContext, error, redactSensitiveFields } from "./tool.helpers.js";
-import { deriveAllowedNetworkIds, scopeFromNetworkId } from "./tool.scope.js";
-import { invokeToolRuntime, toolRuntimeErrorToResult } from "./tool.runtime.js";
-import { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
-import { createIntentTools } from "../../intent/intent.tools.js";
-import { createNetworkTools } from "../../network/network.tools.js";
-import { createOpportunityTools } from "../../opportunity/opportunity.tools.js";
-import { createUtilityTools } from "./utility.tools.js";
-import { createIntegrationTools } from "../../integration/integration.tools.js";
-import { createContactTools } from "../../contact/contact.tools.js";
-import { createAgentTools } from "../../agent/agent.tools.js";
-import { createNegotiationTools } from "../../negotiation/negotiation.tools.js";
-import { createPremiseTools } from "../../premise/premise.tools.js";
-import { createQuestionerTools } from "../../questioner/questioner.tools.js";
-import { createAskUserQuestionTools } from "../../questioner/questioner.ask.tool.js";
-const logger = protocolLogger("ChatTools");
-// ═══════════════════════════════════════════════════════════════════════════════
-// TOOL FACTORY
-// ═══════════════════════════════════════════════════════════════════════════════
 /**
- * Creates all chat tools bound to a specific user context.
- * Resolves user/network identity from DB at init time.
- * Tools are created fresh for each user session to ensure proper isolation.
- *
- * All external dependencies (cache, integration, queue, etc.) are provided
- * via the `deps` parameter — the protocol lib never imports concrete adapters.
+ * @deprecated Canonical location: runtime/foreground/composition/tool.factory
+ * Retained for backward compatibility during IND-544 migration.
+ * Import createChatTools from @indexnetwork/protocol instead.
  */
-export async function createChatTools(deps, preResolvedContext) {
-    const { database, embedder, scraper } = deps;
-    const explicitScope = deps.scopeType && deps.scopeId
-        ? { scopeType: deps.scopeType, scopeId: deps.scopeId }
-        : scopeFromNetworkId(deps.networkId);
-    // ─── Resolve context from DB ───────────────────────────────────────────────
-    // resolveChatContext still accepts a networkId because it loads scoped index
-    // presentation metadata; the canonical request scope is explicitScope.
-    const resolvedContext = preResolvedContext ??
-        (await resolveChatContext({
-            database,
-            userId: deps.userId,
-            networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,
-            sessionId: deps.sessionId,
-            contactsEnabled: deps.contactsEnabled,
-            actionToolsEnabled: deps.actionToolsEnabled,
-        }));
-    if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {
-        resolvedContext.scopeType = explicitScope.scopeType;
-        resolvedContext.scopeId = explicitScope.scopeId;
-    }
-    const allowedNetworkIds = deriveAllowedNetworkIds({
-        memberships: resolvedContext.userNetworks,
-        ...(resolvedContext.scopeType && resolvedContext.scopeId
-            ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }
-            : {}),
-    });
-    // ─── Tool wrapper ──────────────────────────────────────────────────────────
-    /**
-     * Standardized tool factory. Auto-injects resolved context and
-     * provides uniform logging / error handling for every tool.
-     */
-    function defineTool(opts) {
-        return tool(async (query) => {
-            logger.info('Tool invoked', {
-                toolName: opts.name,
-                context: { userId: resolvedContext.userId, scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId },
-                query: redactSensitiveFields(query),
-            });
-            try {
-                return await invokeToolRuntime({
-                    toolName: opts.name,
-                    tool: { handler: async ({ context, query }) => opts.handler({ context, query: query }) },
-                    context: resolvedContext,
-                    query,
-                });
-            }
-            catch (err) {
-                logger.error('Tool failed', {
-                    toolName: opts.name,
-                    error: err instanceof Error ? err.message : String(err),
-                });
-                const runtimeResult = toolRuntimeErrorToResult(err);
-                if (runtimeResult)
-                    return runtimeResult;
-                const reason = err instanceof Error ? err.message : String(err);
-                return error(`Failed to execute ${opts.name}: ${reason}`);
-            }
-        }, { name: opts.name, description: opts.description, schema: opts.querySchema });
-    }
-    // ─── Compile subgraphs ─────────────────────────────────────────────────────
-    // Wrap questionerEnqueue to include scoped/session context when available.
-    const sessionAwareEnqueue = deps.questionerEnqueue
-        ? (input) => deps.questionerEnqueue({
-            ...input,
-            ...(resolvedContext.scopeType && resolvedContext.scopeId && !input.scopeId
-                ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }
-                : {}),
-            ...(resolvedContext.sessionId && !input.conversationId ? { conversationId: resolvedContext.sessionId } : {}),
-        })
-        : undefined;
-    const intentGraph = new IntentGraphFactory(database, embedder, deps.intentQueue, sessionAwareEnqueue).createGraph();
-    const premiseGraph = new PremiseGraphFactory(database, embedder).createGraph();
-    const profileGraph = new EnrichmentGraphFactory(database, scraper, deps.enricher, sessionAwareEnqueue, premiseGraph).createGraph();
-    const hydeCache = deps.hydeCache;
-    const lensInferrer = new LensInferrer();
-    const hydeGenerator = new HydeGenerator();
-    const compiledHydeGraph = new HydeGraphFactory(database, embedder, hydeCache, lensInferrer, hydeGenerator).createGraph();
-    const negotiationGraph = deps.agentDispatcher
-        ? new NegotiationGraphFactory(deps.negotiationDatabase, deps.agentDispatcher, deps.negotiationTimeoutQueue, sessionAwareEnqueue).createGraph()
-        : undefined;
-    const opportunityGraph = new OpportunityGraphFactory(database, embedder, compiledHydeGraph, undefined, // evaluator (default)
-    undefined, // queueNotification
-    negotiationGraph, deps.agentDispatcher, deps.queueNegotiateExisting, deps.stampNewbornOpportunities).createGraph();
-    const networkGraph = new NetworkGraphFactory(database).createGraph();
-    const networkMembershipGraph = new NetworkMembershipGraphFactory(database).createGraph();
-    const intentNetworkGraph = new IntentNetworkGraphFactory(database, new IntentIndexer()).createGraph();
-    // ─── Create context-bound databases ────────────────────────────────────────
-    // Use injected instances when provided (e.g. tests). Otherwise create from the same
-    // database used for graphs so that scope checks (e.g. ensureScopedMembership, opportunity
-    // update) use the same adapter as the rest of the tool pipeline.
-    //
-    // The systemDb's DB-level clamp derives concrete allowed network IDs from the
-    // focused scope envelope plus memberships, rather than consuming a transported
-    // legacy indexScope array.
-    const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);
-    const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, allowedNetworkIds, embedder);
-    // ─── Assemble dependencies ─────────────────────────────────────────────────
-    const cache = deps.cache;
-    const integration = deps.integration;
-    const toolDeps = {
-        database,
-        userDb,
-        systemDb,
-        scraper,
-        embedder,
-        cache,
-        integration,
-        contactService: deps.contactService,
-        contactsEnabled: deps.contactsEnabled,
-        integrationImporter: deps.integrationImporter,
-        enricher: deps.enricher,
-        negotiationDatabase: deps.negotiationDatabase,
-        negotiationTimeoutQueue: deps.negotiationTimeoutQueue,
-        agentDatabase: deps.agentDatabase,
-        grantDefaultSystemPermissions: deps.grantDefaultSystemPermissions,
-        agentDispatcher: deps.agentDispatcher,
-        stampNewbornOpportunities: deps.stampNewbornOpportunities,
-        deliveryLedger: deps.deliveryLedger,
-        discoveryRuns: deps.discoveryRuns,
-        discoveryRunQueue: deps.discoveryRunQueue,
-        enrichmentRuns: deps.enrichmentRuns,
-        enrichmentRunQueue: deps.enrichmentRunQueue,
-        mintConnectToken: deps.mintConnectToken,
-        mintConnectLink: deps.mintConnectLink,
-        frontendUrl: deps.frontendUrl,
-        apiBaseUrl: deps.apiBaseUrl,
-        ...(deps.chatSummary && { chatSummary: deps.chatSummary }),
-        ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),
-        ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),
-        ...(deps.findPendingQuestions && { findPendingQuestions: deps.findPendingQuestions }),
-        ...(deps.answerPendingQuestion && { answerPendingQuestion: deps.answerPendingQuestion }),
-        ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),
-        ...(deps.chatQuestions && { chatQuestions: deps.chatQuestions }),
-        ...(deps.chatSession && { chatSession: deps.chatSession }),
-        ...(deps.getUserContextText && { getUserContextText: deps.getUserContextText }),
-        graphs: {
-            profile: profileGraph,
-            intent: intentGraph,
-            index: networkGraph,
-            networkMembership: networkMembershipGraph,
-            intentIndex: intentNetworkGraph,
-            opportunity: opportunityGraph,
-            premise: premiseGraph,
-        },
-    };
-    // ─── Create domain tools ──────────────────────────────────────────────────
-    const profileTools = createEnrichmentTools(defineTool, toolDeps);
-    const intentTools = createIntentTools(defineTool, toolDeps);
-    const networkTools = createNetworkTools(defineTool, toolDeps);
-    const opportunityTools = createOpportunityTools(defineTool, toolDeps);
-    const utilityTools = createUtilityTools(defineTool, toolDeps);
-    const contactTools = createContactTools(defineTool, toolDeps);
-    const agentTools = createAgentTools(defineTool, toolDeps);
-    const integrationTools = createIntegrationTools(defineTool, toolDeps);
-    const negotiationTools = deps.agentDispatcher
-        ? createNegotiationTools(defineTool, toolDeps)
-        : [];
-    const premiseTools = createPremiseTools(defineTool, toolDeps);
-    const questionerTools = createQuestionerTools(defineTool, toolDeps);
-    // Blocking mid-conversation questions — chat-only (never in the MCP registry),
-    // and only when the host provides the ChatQuestionsHost bridge.
-    const askUserQuestionTools = deps.chatQuestions
-        ? createAskUserQuestionTools(defineTool, toolDeps)
-        : [];
-    // confirm_opportunity_delivery is an OpenClaw-delivery ledger write and must not be
-    // callable from regular chat sessions.
-    const chatOpportunityToolExclusions = new Set([
-        "confirm_opportunity_delivery",
-    ]);
-    const opportunityToolsForChat = opportunityTools.filter((t) => !chatOpportunityToolExclusions.has(t.name));
-    return [
-        ...profileTools,
-        ...intentTools,
-        ...networkTools,
-        ...opportunityToolsForChat,
-        ...utilityTools,
-        ...integrationTools,
-        ...contactTools,
-        ...agentTools,
-        ...negotiationTools,
-        ...premiseTools,
-        ...questionerTools,
-        ...askUserQuestionTools,
-    ];
-}
-//# sourceMappingURL=tool.factory.js.map
+export { createChatTools, } from "../../runtime/foreground/composition/tool.factory.js";

package/dist/shared/agent/tool.helpers.d.ts

@@ -2,11 +2,9 @@ import { z } from "zod";
 import type { ModelConfig } from "./model.config.js";
 import type { ToolScopeType } from "./tool.scope.js";
 import type { UserIdentity } from "../schemas/identity.schema.js";
-import type { ChatGraphCompositeDatabase, NetworkMembership, UserRecord, UserDatabase, SystemDatabase, NegotiationGraphDatabase } from "../interfaces/database.interface.js";
+import type { ChatGraphCompositeDatabase, CreateOpportunityData, NetworkMembership, UserRecord, UserDatabase, SystemDatabase, NegotiationGraphDatabase } from "../interfaces/database.interface.js";
 import type { Scraper } from "../interfaces/scraper.interface.js";
 import type { Cache, HydeCache } from "../interfaces/cache.interface.js";
-import type { CompiledOpportunityGraph } from "../../opportunity/opportunity.discover.js";
-import type { StampNewbornOpportunitiesFn } from "../../opportunity/opportunity.graph.js";
 import type { IntegrationAdapter } from "../interfaces/integration.interface.js";
 import type { ContactServiceAdapter } from "../interfaces/contact.interface.js";
 import type { ProfileEnricher } from "../interfaces/enrichment.interface.js";
@@ -42,6 +40,12 @@ export interface ToolErrorReport {
 export type CompiledGraph = {
     invoke: (input: any) => Promise<any>;
 };
+/** Composition-only hook kept structural so shared contracts do not own opportunity runtime. */
+export type StampNewbornOpportunitiesFn = (input: {
+    ownerUserId: string;
+    intentId: string;
+    items: CreateOpportunityData[];
+}) => Promise<CreateOpportunityData[]>;
 /**
  * Resolved context available to every tool handler.
  * Contains the current user and optional network identity, resolved from DB at init.
@@ -114,7 +118,8 @@ export interface ResolvedToolContext {
  * Note: userDb and systemDb are optional inputs - if not provided, createChatTools
  * will create them internally from the chatDatabaseAdapter singleton.
  */
-export interface ToolContext {
+/** Complete host binding set used only to derive request and composition ports. */
+interface ToolContextBindings {
     userId: string;
     /** @deprecated Use userDb or systemDb instead. Kept for backwards compatibility. */
     database: ChatGraphCompositeDatabase;
@@ -201,7 +206,7 @@ export interface ToolContext {
      */
     chatQuestions?: ChatQuestionsHost;
     /** Optional durable persistence for reporter cleanup-action proposals. */
-    actionProposalStore?: import('../../chat/reporter.action.tools.js').AgentActionProposalStore;
+    actionProposalStore?: import('../../chat/reporter.action.contracts.js').AgentActionProposalStore;
     /**
      * Host bridge for the negotiator persona's `remember`/`forget` memory
      * tools (P5.4). Injected by the composition root only when negotiator
@@ -289,12 +294,24 @@ export interface ToolContext {
         scope?: 'tool' | 'principal';
     }>;
 }
+/** Per-request chat identity, scope, and adapter inputs. */
+export type ChatToolRequest = Pick<ToolContextBindings, 'userId' | 'userDb' | 'systemDb' | 'networkId' | 'scopeType' | 'scopeId' | 'indexScope' | 'sessionId'>;
+/** Host-owned bindings injected into a chat request at the composition boundary. */
+export type ChatToolHostDeps = Omit<ToolContextBindings, keyof ChatToolRequest>;
 /**
- * All external dependencies needed to initialize the protocol tool engine.
- * The host application (composition root) must provide concrete implementations.
- * This is the subset of ToolContext that is NOT per-request (no userId, indexId, sessionId).
+ * Compatibility context for the chat factory.
+ *
+ * New tool factories receive capability-specific `*ToolDeps` ports, while
+ * this request-plus-host intersection keeps existing chat/persona consumers
+ * structurally compatible during incremental migration.
+ */
+export type ToolContext = ChatToolRequest & ChatToolHostDeps;
+/**
+ * All host dependencies needed to initialize the protocol chat engine.
+ * User and system database views are created per request unless supplied by a
+ * compatibility caller.
  */
-export type ProtocolDeps = Omit<ToolContext, 'userId' | 'indexId' | 'sessionId' | 'userDb' | 'systemDb'>;
+export type ProtocolDeps = ChatToolHostDeps;
 /**
  * Thrown when a requested chat scope is invalid for the authenticated user.
  * Controllers can map this to an HTTP status code.
@@ -353,7 +370,14 @@ export type ToolRegistry = Map<string, RawToolDefinition>;
  * Shared dependencies available to all tool domain factories.
  * Passed by `createChatTools` after compiling all subgraphs.
  */
-export interface ToolDeps {
+/**
+ * Host bindings available while composing the protocol tool registry.
+ *
+ * This is deliberately not exported as a consumer contract. Individual tool
+ * factories receive the use-case ports below; `ToolDeps` remains the complete
+ * compatibility shape only for registry/composition callers during migration.
+ */
+interface ToolDepsBindings {
     /** @deprecated Use userDb or systemDb instead. Kept for backwards compatibility. */
     database: ChatGraphCompositeDatabase;
     /** Context-bound database for accessing the authenticated user's own resources. */
@@ -510,7 +534,7 @@ export interface ToolDeps {
         index: CompiledGraph;
         networkMembership: CompiledGraph;
         intentIndex: CompiledGraph;
-        opportunity: CompiledOpportunityGraph;
+        opportunity: CompiledGraph;
         premise: CompiledGraph;
     };
     /**
@@ -533,6 +557,21 @@ export interface ToolDeps {
      */
     getUserContextText?: (userId: string) => Promise<string>;
 }
+/**
+ * Shared backing shape for the registry composition boundary. Capability-local
+ * ports may Pick from this type, but it is intentionally not a root export.
+ */
+export type ToolRegistryCompositionDeps = Omit<ToolDepsBindings, 'embedder' | 'chatMessageWriter' | 'mintConnectToken' | 'apiBaseUrl' | 'mcpRateLimiter'>;
+/** Runtime-only hooks retained for MCP and existing host composition. */
+type ToolRuntimeCompatibilityDeps = Pick<ToolDepsBindings, 'embedder' | 'chatMessageWriter' | 'mintConnectToken' | 'apiBaseUrl' | 'mcpRateLimiter'>;
+/**
+ * Legacy complete tool composition contract.
+ *
+ * New capability factories must accept their named `*ToolDeps` port above,
+ * rather than this aggregate. Keeping the intersection preserves structural
+ * compatibility for the registry and host composition while consumers migrate.
+ */
+export type ToolDeps = ToolRegistryCompositionDeps & ToolRuntimeCompatibilityDeps;
 export declare function success<T>(data: T): string;
 export declare function error(message: string, debugSteps?: Array<{
     step: string;
@@ -580,4 +619,4 @@ export declare function extractUrls(text: string): string[];
  * @returns A new value with sensitive fields replaced by `"[redacted]"`.
  */
 export declare function redactSensitiveFields(value: unknown): unknown;
-//# sourceMappingURL=tool.helpers.d.ts.map
+export {};

package/dist/shared/agent/tool.helpers.js

@@ -234,4 +234,3 @@ export function redactSensitiveFields(value) {
     }
     return out;
 }
-//# sourceMappingURL=tool.helpers.js.map

package/dist/shared/agent/tool.registry.d.ts

@@ -1,12 +1,12 @@
-import type { ToolDeps, ToolRegistry } from './tool.helpers.js';
 /**
- * Creates a tool registry containing all tool handlers indexed by name.
- * Handlers are raw async functions (not LangChain tool() wrappers) that
- * accept { context, query } and return a JSON string.
+ * Compatibility re-export shim — IND-543.
  *
- * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)
- * @param context - Resolved user context for this request.
- * @returns Map of tool name to raw tool definition.
+ * The canonical implementation has moved to
+ *   runtime/foreground/composition/tool.registry.ts
+ * (interaction-composition concern).
+ *
+ * This shim preserves all existing import paths inside the package and in
+ * src/index.ts so that consumers need zero changes from this relocation.
+ * It will be removed once direct importers are migrated.
  */
-export declare function createToolRegistry(deps: ToolDeps): ToolRegistry;
-//# sourceMappingURL=tool.registry.d.ts.map
+export { createToolRegistry } from '../../runtime/foreground/composition/tool.registry.js';

package/dist/shared/agent/tool.registry.js

@@ -1,107 +1,12 @@
-import { error, redactSensitiveFields } from './tool.helpers.js';
-import { createEnrichmentTools } from '../../enrichment/enrichment.tools.js';
-import { createIntentTools } from '../../intent/intent.tools.js';
-import { createNetworkTools } from '../../network/network.tools.js';
-import { createOpportunityTools } from '../../opportunity/opportunity.tools.js';
-import { createUtilityTools } from './utility.tools.js';
-import { createIntegrationTools } from '../../integration/integration.tools.js';
-import { createContactTools } from '../../contact/contact.tools.js';
-import { createAgentTools } from '../../agent/agent.tools.js';
-import { createNegotiationTools } from '../../negotiation/negotiation.tools.js';
-import { createChatTools } from '../../chat/chat.tools.js';
-import { createPremiseTools } from '../../premise/premise.tools.js';
-import { createQuestionerTools } from '../../questioner/questioner.tools.js';
-import { protocolLogger } from '../observability/protocol.logger.js';
-import { requestContext } from '../observability/request-context.js';
-const logger = protocolLogger('ToolRegistry');
 /**
- * Creates a tool registry containing all tool handlers indexed by name.
- * Handlers are raw async functions (not LangChain tool() wrappers) that
- * accept { context, query } and return a JSON string.
+ * Compatibility re-export shim — IND-543.
  *
- * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)
- * @param context - Resolved user context for this request.
- * @returns Map of tool name to raw tool definition.
+ * The canonical implementation has moved to
+ *   runtime/foreground/composition/tool.registry.ts
+ * (interaction-composition concern).
+ *
+ * This shim preserves all existing import paths inside the package and in
+ * src/index.ts so that consumers need zero changes from this relocation.
+ * It will be removed once direct importers are migrated.
  */
-export function createToolRegistry(deps) {
-    const registry = new Map();
-    // defineTool that captures raw handlers into the registry
-    function defineTool(opts) {
-        const entry = {
-            name: opts.name,
-            description: opts.description,
-            schema: opts.querySchema,
-            handler: async (input) => {
-                logger.verbose('Tool invoked', {
-                    toolName: opts.name,
-                    context: { userId: input.context.userId, scopeType: input.context.scopeType, scopeId: input.context.scopeId },
-                    query: redactSensitiveFields(input.query),
-                });
-                try {
-                    return await opts.handler({ context: input.context, query: input.query });
-                }
-                catch (err) {
-                    const abortSignal = requestContext.getStore()?.abortSignal;
-                    if (abortSignal?.aborted) {
-                        throw err;
-                    }
-                    logger.error('Tool failed', {
-                        toolName: opts.name,
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                    return error(`Failed to execute ${opts.name}: ${err instanceof Error ? err.message : String(err)}`);
-                }
-            },
-        };
-        registry.set(opts.name, entry);
-        // Return a dummy — create*Tools functions collect return values into arrays,
-        // but for the registry path we only need the side-effect on the Map.
-        return null;
-    }
-    // Create all tool domains -- each one calls defineTool() which populates the registry.
-    // The local defineTool is compatible with DefineTool (which returns any).
-    const dt = defineTool;
-    createEnrichmentTools(dt, deps);
-    createIntentTools(dt, deps);
-    createNetworkTools(dt, deps);
-    createOpportunityTools(dt, deps);
-    createUtilityTools(dt, deps);
-    createIntegrationTools(dt, deps);
-    createContactTools(dt, deps);
-    createAgentTools(dt, deps);
-    createNegotiationTools(dt, deps);
-    createPremiseTools(dt, deps);
-    createQuestionerTools(dt, deps);
-    if (deps.chatSession) {
-        createChatTools(dt, deps);
-    }
-    // Deprecated tool-name aliases (IND-371). The canonical implementations are now
-    // registered under their *_user_context / *_enrichment_run names; we expose the
-    // legacy *_user_profile / *_profile_run names as thin aliases that delegate to the
-    // exact same handler + schema, so existing MCP clients keep working while they
-    // migrate. The old names are removed in IND-373.
-    const DEPRECATED_TOOL_ALIASES = [
-        ["read_user_profiles", "read_user_contexts"],
-        ["create_user_profile", "create_user_context"],
-        ["update_user_profile", "update_user_context"],
-        ["confirm_user_profile", "confirm_user_context"],
-        ["preview_user_profile", "preview_user_context"],
-        ["get_profile_run", "get_enrichment_run"],
-        ["cancel_profile_run", "cancel_enrichment_run"],
-    ];
-    for (const [oldName, canonicalName] of DEPRECATED_TOOL_ALIASES) {
-        const canonical = registry.get(canonicalName);
-        if (!canonical) {
-            logger.warn('Cannot register deprecated alias: canonical tool not found', { alias: oldName, canonicalName });
-            continue;
-        }
-        registry.set(oldName, {
-            ...canonical,
-            name: oldName,
-            description: `[DEPRECATED — use \`${canonicalName}\` instead; this alias is retained for backward compatibility and will be removed.] ${canonical.description}`,
-        });
-    }
-    logger.verbose('Tool registry created', { toolCount: registry.size });
-    return registry;
-}
-//# sourceMappingURL=tool.registry.js.map
+export { createToolRegistry } from '../../runtime/foreground/composition/tool.registry.js';

package/dist/shared/agent/tool.runtime.d.ts

@@ -26,4 +26,3 @@ export declare class ToolRuntimeError extends Error {
 }
 export declare function invokeToolRuntime(input: ToolInvocationRuntimeInput): Promise<string>;
 export declare function toolRuntimeErrorToResult(err: unknown): string | null;
-//# sourceMappingURL=tool.runtime.d.ts.map

package/dist/shared/agent/tool.runtime.js

@@ -214,4 +214,3 @@ export function toolRuntimeErrorToResult(err) {
         },
     });
 }
-//# sourceMappingURL=tool.runtime.js.map

package/dist/shared/agent/tool.scope.d.ts

@@ -42,4 +42,3 @@ export declare function focusedNetworkLabel(scope: ToolScopeEnvelope & {
 }): string;
 export declare function deriveAllowedNetworkIds(input: DeriveNetworkScopeInput): string[];
 export declare function deriveDiscoveryNetworkIds(input: DeriveNetworkScopeInput): string[];
-//# sourceMappingURL=tool.scope.d.ts.map

package/dist/shared/agent/tool.scope.js

@@ -48,4 +48,3 @@ export function deriveDiscoveryNetworkIds(input) {
         ? [input.scopeId]
         : [];
 }
-//# sourceMappingURL=tool.scope.js.map

package/dist/shared/agent/utility.tools.d.ts

@@ -1,3 +1,5 @@
-import type { DefineTool, ToolDeps } from "./tool.helpers.js";
-export declare function createUtilityTools(defineTool: DefineTool, deps: ToolDeps): readonly [any, any, any];
-//# sourceMappingURL=utility.tools.d.ts.map
+import type { DefineTool, ToolRegistryCompositionDeps } from "./tool.helpers.js";
+/** Host capabilities consumed by URL and profile utility tools. */
+type UtilityToolDeps = Pick<ToolRegistryCompositionDeps, "scraper" | "userDb">;
+export declare function createUtilityTools(defineTool: DefineTool, deps: UtilityToolDeps): readonly [any, any, any];
+export {};

package/dist/shared/agent/utility.tools.js

@@ -289,4 +289,3 @@ Discovery is the process of finding meaningful connections between users based o
     });
     return [scrapeUrl, readDocs, reportAgentActivity];
 }
-//# sourceMappingURL=utility.tools.js.map

package/dist/shared/assignment/network-assignment.policy.d.ts

@@ -59,4 +59,3 @@ export declare function buildNetworkAssignmentDecision(args: BuildNetworkAssignm
  * @returns Final normalized score in the 0..1 range.
  */
 export declare function combineAssignmentScores(rawScores: NetworkAssignmentRawScores, promptPresence: NetworkAssignmentPromptPresence): number;
-//# sourceMappingURL=network-assignment.policy.d.ts.map

package/dist/shared/assignment/network-assignment.policy.js

@@ -103,4 +103,3 @@ function clampScore(score) {
         return 0;
     return Math.max(0, Math.min(1, score));
 }
-//# sourceMappingURL=network-assignment.policy.js.map

package/dist/shared/hyde/hyde.documents.d.ts

@@ -7,4 +7,3 @@ export declare function computeHydeSourceTextHash(sourceText: string): string;
  * mode and, for frame-v1, the newest generation marker group.
  */
 export declare function selectHydeDocumentsForGeneration(documents: HydeDocument[], mode: HydeGenerationMode, sourceText: string): HydeDocument[];
-//# sourceMappingURL=hyde.documents.d.ts.map

package/dist/shared/hyde/hyde.documents.js

@@ -47,4 +47,3 @@ export function selectHydeDocumentsForGeneration(documents, mode, sourceText) {
         ? eligible.filter((document) => document.context?.generatedAt === newestGeneratedAt)
         : [];
 }
-//# sourceMappingURL=hyde.documents.js.map

package/dist/shared/hyde/hyde.env.d.ts

@@ -6,4 +6,3 @@ export type HydeGenerationMode = 'legacy' | typeof HYDE_FRAME_GENERATION_VERSION
  * Only the exact literal `true` enables frame-constrained generation.
  */
 export declare function getHydeGenerationMode(value?: string | undefined): HydeGenerationMode;
-//# sourceMappingURL=hyde.env.d.ts.map

package/dist/shared/hyde/hyde.env.js

@@ -7,4 +7,3 @@ export const HYDE_FRAME_GENERATION_VERSION = 'frame-v1';
 export function getHydeGenerationMode(value = process.env.HYDE_FRAME_CONSTRAINTS_ENABLED) {
     return value === 'true' ? HYDE_FRAME_GENERATION_VERSION : 'legacy';
 }
-//# sourceMappingURL=hyde.env.js.map

package/dist/shared/hyde/hyde.frame.d.ts

@@ -78,11 +78,11 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
         evidence: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
+        type: "location" | "organization" | "other" | "person" | "product" | "event";
         evidence: string;
     }, {
         name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
+        type: "location" | "organization" | "other" | "person" | "product" | "event";
         evidence: string;
     }>, "many">;
     domainVocabulary: z.ZodArray<z.ZodObject<{
@@ -111,7 +111,7 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
     }[];
     namedEntities: {
         name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
+        type: "location" | "organization" | "other" | "person" | "product" | "event";
         evidence: string;
     }[];
     domainVocabulary: {
@@ -134,7 +134,7 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
     }[];
     namedEntities: {
         name: string;
-        type: "location" | "event" | "organization" | "other" | "person" | "product";
+        type: "location" | "organization" | "other" | "person" | "product" | "event";
         evidence: string;
     }[];
     domainVocabulary: {
@@ -148,4 +148,3 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
  * substantive tokens; counterpart roles may add generic inferred role language.
  */
 export declare function sanitizeHydeSourceFrame(sourceText: string, frame: HydeSourceFrame): HydeSourceFrame;
-//# sourceMappingURL=hyde.frame.d.ts.map

package/dist/shared/hyde/hyde.frame.js

@@ -105,4 +105,3 @@ export function sanitizeHydeSourceFrame(sourceText, frame) {
             .filter((item) => containsAlphanumericSpanCaseInsensitive(item.evidence, item.term)),
     };
 }
-//# sourceMappingURL=hyde.frame.js.map

package/dist/shared/hyde/hyde.generator.d.ts

@@ -36,4 +36,3 @@ export declare class HydeGenerator {
     /** Generate a hypothetical document for the given source text and lens. */
     generate(input: HydeGenerateInput): Promise<HydeGeneratorOutput>;
 }
-//# sourceMappingURL=hyde.generator.d.ts.map

package/dist/shared/hyde/hyde.generator.js

@@ -101,4 +101,3 @@ __decorate([
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], HydeGenerator.prototype, "generate", null);
-//# sourceMappingURL=hyde.generator.js.map