@indexnetwork/protocol 13.2.0-rc.466.1 → 13.2.1-rc.467.1

package/dist/runtime/foreground/composition/tool.factory.js

@@ -1,235 +0,0 @@
-import { tool } from "@langchain/core/tools";
-import { IntentGraphFactory } from "../../../signals/application/intent.graph.js";
-import { EnrichmentGraphFactory } from "../../../enrichment/enrichment.graph.js";
-import { OpportunityGraphFactory } from "../../../capabilities/opportunities.facade.js";
-import { HydeGraphFactory } from "../../../shared/hyde/hyde.graph.js";
-import { HydeGenerator } from "../../../shared/hyde/hyde.generator.js";
-import { LensInferrer } from "../../../shared/hyde/lens.inferrer.js";
-import { NetworkGraphFactory, NetworkMembershipGraphFactory, IntentNetworkGraphFactory } from "../../../capabilities/communities.facade.js";
-import { IntentIndexer } from "../../../signals/application/intent.indexer.js";
-import { NegotiationGraphFactory } from "../../../capabilities/negotiation.facade.js";
-import { PremiseGraphFactory } from "../../../premise/premise.graph.js";
-import { protocolLogger } from "../../../shared/observability/protocol.logger.js";
-import { resolveChatContext, error, redactSensitiveFields } from "../../../shared/agent/tool.helpers.js";
-import { deriveAllowedNetworkIds, focusedIntentId, scopeFromNetworkId } from "../../../shared/agent/tool.scope.js";
-import { invokeToolRuntime, toolRuntimeErrorToResult } from "../../../shared/agent/tool.runtime.js";
-import { createEnrichmentTools } from "../../../enrichment/enrichment.tools.js";
-import { createIntentTools } from "../signals/intent.tools.js";
-import { createNetworkTools } from "../../../capabilities/communities.facade.js";
-import { createOpportunityTools } from "../../../capabilities/opportunities.facade.js";
-import { createUtilityTools } from "../../../shared/agent/utility.tools.js";
-import { createIntegrationTools } from "../../../capabilities/integrations.facade.js";
-import { createContactTools } from "../../../capabilities/contacts.facade.js";
-import { createAgentTools } from "../../../capabilities/participant-agents.tools.facade.js";
-import { createNegotiationTools } from "../../../capabilities/negotiation.facade.js";
-import { createPremiseTools } from "../../../premise/premise.tools.js";
-import { createQuestionerTools, createAskUserQuestionTools } from "../../../capabilities/questions.facade.js";
-import { bindOwnerApprovalProvenance } from "../../../opportunity/application/opportunity.owner-provenance.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.
- */
-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;
-    }
-    // This factory is an orchestrated chat surface, never a direct owner request.
-    // Bind that fact at composition time rather than inferring it from a session
-    // id or a caller-controlled tool argument inside the opportunity handler.
-    bindOwnerApprovalProvenance(resolvedContext, {
-        surface: 'chat',
-        sessionAuthenticated: false,
-    });
-    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, 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,
-        ...(deps.opportunityOwnerApproval && { opportunityOwnerApproval: deps.opportunityOwnerApproval }),
-        enrichmentRuns: deps.enrichmentRuns,
-        enrichmentRunQueue: deps.enrichmentRunQueue,
-        frontendUrl: deps.frontendUrl,
-        apiBaseUrl: deps.apiBaseUrl,
-        ...(deps.chatSummary && { chatSummary: deps.chatSummary }),
-        ...(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 }),
-        ...(deps.intentProposalStore && { intentProposalStore: deps.intentProposalStore }),
-        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);
-    // An intent-scoped conversation exists to refine its selected signal. Keep
-    // creation out of the model-visible registry; the update handler separately
-    // clamps writes to the exact scoped intent as a runtime backstop.
-    const intentToolsForChat = focusedIntentId(resolvedContext)
-        ? intentTools.filter((candidate) => candidate.name !== "create_intent")
-        : intentTools;
-    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,
-        ...intentToolsForChat,
-        ...networkTools,
-        ...opportunityToolsForChat,
-        ...utilityTools,
-        ...integrationTools,
-        ...contactTools,
-        ...agentTools,
-        ...negotiationTools,
-        ...premiseTools,
-        ...questionerTools,
-        ...askUserQuestionTools,
-    ];
-}

package/dist/runtime/foreground/composition/tool.registry.d.ts

@@ -1,24 +0,0 @@
-import type { ToolDeps, ToolRegistry } from '../../../shared/agent/tool.helpers.js';
-import type { ToolSurface } from '../../../shared/agent/utility.tools.js';
-import type { OpportunityOwnerApprovalDeps } from '../../../opportunity/ports/opportunity.tools.port.js';
-export interface CreateToolRegistryOptions {
-    /**
-     * Tool-surface profile. The default `'rest'` profile (direct HTTP Tool API)
-     * exposes contact/Gmail tools and `scrape_url`. The restricted `'mcp'`
-     * profile omits those surfaces (IND-596/597). Retired profile/profile-run
-     * compatibility aliases are absent from both profiles (IND-373/598).
-     */
-    surface?: ToolSurface;
-}
-/**
- * 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.
- *
- * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)
- * @param options - Surface profile selecting the MCP-restricted or full REST set.
- * @returns Map of tool name to raw tool definition.
- */
-/** Complete registry composition with the opportunity-local owner-proof port. */
-export type ToolRegistryDeps = ToolDeps & OpportunityOwnerApprovalDeps;
-export declare function createToolRegistry(deps: ToolRegistryDeps, options?: CreateToolRegistryOptions): ToolRegistry;

package/dist/runtime/foreground/composition/tool.registry.js

@@ -1,80 +0,0 @@
-import { error, redactSensitiveFields } from '../../../shared/agent/tool.helpers.js';
-import { createEnrichmentTools } from '../../../enrichment/enrichment.tools.js';
-import { createIntentTools } from '../signals/intent.tools.js';
-import { createNetworkTools } from '../../../capabilities/communities.facade.js';
-import { createOpportunityTools } from '../../../capabilities/opportunities.facade.js';
-import { createUtilityTools } from '../../../shared/agent/utility.tools.js';
-import { createIntegrationTools } from '../../../capabilities/integrations.facade.js';
-import { createContactTools } from '../../../capabilities/contacts.facade.js';
-import { createAgentTools } from '../../../capabilities/participant-agents.tools.facade.js';
-import { createNegotiationTools } from '../../../capabilities/negotiation.facade.js';
-import { createChatTools } from '../../../chat/chat.tools.js';
-import { createPremiseTools } from '../../../premise/premise.tools.js';
-import { createQuestionerTools } from '../../../capabilities/questions.facade.js';
-import { protocolLogger } from '../../../shared/observability/protocol.logger.js';
-import { requestContext } from '../../../shared/observability/request-context.js';
-const logger = protocolLogger('ToolRegistry');
-export function createToolRegistry(deps, options = {}) {
-    const registry = new Map();
-    const isMcpSurface = options.surface === 'mcp';
-    // 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);
-    // Utility tools always register read_docs + read_activity_summary; on the
-    // MCP surface scrape_url is omitted and read_docs guidance is sanitized
-    // (IND-597). The retired report_agent_activity name retains no alias on
-    // either surface (IND-605).
-    createUtilityTools(dt, deps, { surface: isMcpSurface ? 'mcp' : 'rest' });
-    // Contact/Gmail import tools are omitted from the MCP surface (IND-596). Their
-    // implementations remain available to the REST Tool API and chat agent.
-    if (!isMcpSurface) {
-        createIntegrationTools(dt, deps);
-        createContactTools(dt, deps);
-    }
-    createAgentTools(dt, deps);
-    createNegotiationTools(dt, deps);
-    createPremiseTools(dt, deps);
-    createQuestionerTools(dt, deps);
-    if (deps.chatSession) {
-        createChatTools(dt, deps);
-    }
-    logger.verbose('Tool registry created', { toolCount: registry.size, surface: options.surface ?? 'rest' });
-    return registry;
-}

package/dist/runtime/foreground/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * runtime/foreground — IND-543 outer shell.
- *
- * Entry point for participant-directed (foreground) interaction composition:
- * tool registry assembly, chat adapters, MCP adapters, persona adapters.
- *
- * Boundary: interaction-composition.  May import from any capability via its
- * capabilities/*.facade.ts contract.  Must not import host implementations.
- *
- * Curated temporary alias — the canonical implementation lives here;
- * shared/agent/tool.registry.ts is a backward-compat shim that delegates here.
- */
-export { createToolRegistry } from './composition/tool.registry.js';

package/dist/runtime/foreground/index.js

@@ -1,13 +0,0 @@
-/**
- * runtime/foreground — IND-543 outer shell.
- *
- * Entry point for participant-directed (foreground) interaction composition:
- * tool registry assembly, chat adapters, MCP adapters, persona adapters.
- *
- * Boundary: interaction-composition.  May import from any capability via its
- * capabilities/*.facade.ts contract.  Must not import host implementations.
- *
- * Curated temporary alias — the canonical implementation lives here;
- * shared/agent/tool.registry.ts is a backward-compat shim that delegates here.
- */
-export { createToolRegistry } from './composition/tool.registry.js';

package/dist/runtime/foreground/signals/intent.tools.d.ts

@@ -1,13 +0,0 @@
-/**
- * runtime/foreground/signals/intent.tools — foreground signals-adapter seam.
- *
- * Canonical runtime registration point for intent/signal tools in the
- * participant-facing (foreground) interaction layer.  Re-exports the tool
- * factory from the signals application layer so the foreground tool registry
- * consumes the adapter rather than reaching directly into the signals
- * implementation directory.
- *
- * Boundary: interaction-composition.  Imports signals only via the signals
- * application contracts; must not import host implementations.
- */
-export { createIntentTools, setIntentClarifierForTesting, describeIntentUpdateFailure, } from "../../../signals/application/intent.tools.js";

package/dist/runtime/foreground/signals/intent.tools.js

@@ -1,13 +0,0 @@
-/**
- * runtime/foreground/signals/intent.tools — foreground signals-adapter seam.
- *
- * Canonical runtime registration point for intent/signal tools in the
- * participant-facing (foreground) interaction layer.  Re-exports the tool
- * factory from the signals application layer so the foreground tool registry
- * consumes the adapter rather than reaching directly into the signals
- * implementation directory.
- *
- * Boundary: interaction-composition.  Imports signals only via the signals
- * application contracts; must not import host implementations.
- */
-export { createIntentTools, setIntentClarifierForTesting, describeIntentUpdateFailure, } from "../../../signals/application/intent.tools.js";

package/dist/signals/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * signals — domain-first module root.
- *
- * Re-exports the curated public surface.  Other modules inside the signals
- * capability import directly from signals/domain, signals/application, or
- * signals/ports; this barrel is for cross-capability consumers that must go
- * through the signals public surface.
- *
- * IND-544: canonical home for intent/signal behaviour that was previously
- * spread across intent/*.  Legacy intent/* paths remain as compatibility
- * re-exports pointing here.
- */
-export * from "./public/index.js";

package/dist/signals/index.js

@@ -1,13 +0,0 @@
-/**
- * signals — domain-first module root.
- *
- * Re-exports the curated public surface.  Other modules inside the signals
- * capability import directly from signals/domain, signals/application, or
- * signals/ports; this barrel is for cross-capability consumers that must go
- * through the signals public surface.
- *
- * IND-544: canonical home for intent/signal behaviour that was previously
- * spread across intent/*.  Legacy intent/* paths remain as compatibility
- * re-exports pointing here.
- */
-export * from "./public/index.js";