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

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

@@ -1,12 +1,80 @@
-/**
- * Compatibility re-export shim — IND-543.
- *
- * 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 { createToolRegistry } from '../../runtime/foreground/composition/tool.registry.js';
+import { error, redactSensitiveFields } from './tool.helpers.js';
+import { createEnrichmentTools } from '../../enrichment/enrichment.tools.js';
+import { createIntentTools } from '../../signals/application/intent.tools.js';
+import { createNetworkTools } from '../../capabilities/communities.facade.js';
+import { createOpportunityTools } from '../../capabilities/opportunities.facade.js';
+import { createUtilityTools } from './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 '../observability/protocol.logger.js';
+import { requestContext } from '../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/signals/application/index.d.ts

@@ -4,7 +4,7 @@
  * Houses the LangGraph factory, model-binding adapters (inferrer, clarifier,
  * verifier, reconciler, indexer), and the tool-definition factory.
  * Participant-facing runtime tool registration lives in the foreground shell
- * (runtime/foreground/signals/intent.tools).
+ * (shared/agent/tool.factory).
  *
  * Boundary: may import from signals/domain and signals/ports, plus
  * only-when-needed LangGraph / model-binding seams inside this directory.

package/dist/signals/application/index.js

@@ -4,7 +4,7 @@
  * Houses the LangGraph factory, model-binding adapters (inferrer, clarifier,
  * verifier, reconciler, indexer), and the tool-definition factory.
  * Participant-facing runtime tool registration lives in the foreground shell
- * (runtime/foreground/signals/intent.tools).
+ * (shared/agent/tool.factory).
  *
  * Boundary: may import from signals/domain and signals/ports, plus
  * only-when-needed LangGraph / model-binding seams inside this directory.

package/dist/signals/public/index.d.ts

@@ -4,10 +4,10 @@
  * Re-exports the stable contracts from domain, application, and ports.
  * Runtime adapter creation (createIntentTools) is NOT exported here; it is
  * accessible via capabilities/signals.facade for package consumers and via
- * the foreground shell (runtime/foreground/signals) for internal registries.
+ * the tool composition root (shared/agent) for internal registries.
  *
  * Boundary: public-compatibility.  References only signals/domain,
- * signals/application, and signals/ports — never runtime/foreground or
+ * signals/application, and signals/ports — never the tool composition root (shared/agent) or
  * host implementations.
  */
 export { type VerifiedIntent, type IntentValidationFailureCategory, type IntentValidationFailure, type ExecutionResult, IntentGraphState, DEFAULT_SPECIFICITY_WARNING, } from "../domain/index.js";

package/dist/signals/public/index.js

@@ -4,10 +4,10 @@
  * Re-exports the stable contracts from domain, application, and ports.
  * Runtime adapter creation (createIntentTools) is NOT exported here; it is
  * accessible via capabilities/signals.facade for package consumers and via
- * the foreground shell (runtime/foreground/signals) for internal registries.
+ * the tool composition root (shared/agent) for internal registries.
  *
  * Boundary: public-compatibility.  References only signals/domain,
- * signals/application, and signals/ports — never runtime/foreground or
+ * signals/application, and signals/ports — never the tool composition root (shared/agent) or
  * host implementations.
  */
 // ── Domain contracts ──────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "13.2.0-rc.466.1",
+  "version": "13.2.1-rc.467.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/communities/index.d.ts

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

package/dist/communities/index.js

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

package/dist/contacts/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * contacts — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the contacts
- * capability import directly from contacts/domain, contacts/application, or
- * contacts/ports; this barrel is for cross-capability consumers that must
- * go through the contacts public surface.
- *
- * IND-549: canonical home for contact management capabilities.
- *
- * Retains participant reachability semantics: all operations are scoped to
- * the owning user's personal network. Contacts are participants with whom
- * opportunity discovery is run.
- *
- * Compatibility path:
- * - capabilities/contacts.facade.ts — thin re-export via contacts/public
- */
-export * from "./public/index.js";

package/dist/contacts/index.js

@@ -1,18 +0,0 @@
-/**
- * contacts — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the contacts
- * capability import directly from contacts/domain, contacts/application, or
- * contacts/ports; this barrel is for cross-capability consumers that must
- * go through the contacts public surface.
- *
- * IND-549: canonical home for contact management capabilities.
- *
- * Retains participant reachability semantics: all operations are scoped to
- * the owning user's personal network. Contacts are participants with whom
- * opportunity discovery is run.
- *
- * Compatibility path:
- * - capabilities/contacts.facade.ts — thin re-export via contacts/public
- */
-export * from "./public/index.js";

package/dist/integrations/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * integrations — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the integrations
- * capability import directly from integrations/domain, integrations/application,
- * or integrations/ports; this barrel is for cross-capability consumers that
- * must go through the integrations public surface.
- *
- * IND-549: canonical home for integration capabilities.
- *
- * Retains host-integration configuration/actions semantics: the module owns
- * the OAuth session lifecycle and bulk contact import pipeline contracts.
- * Runtime foreground transport (authentication headers, request context) and
- * all-capability composition remain in runtime/foreground.
- *
- * Allowed outbound capability dependencies: none (empty set). The integrations
- * module is a leaf capability that only depends on shared/ primitives.
- *
- * Compatibility path:
- * - capabilities/integrations.facade.ts — thin re-export via integrations/public
- */
-export * from "./public/index.js";

package/dist/integrations/index.js

@@ -1,22 +0,0 @@
-/**
- * integrations — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the integrations
- * capability import directly from integrations/domain, integrations/application,
- * or integrations/ports; this barrel is for cross-capability consumers that
- * must go through the integrations public surface.
- *
- * IND-549: canonical home for integration capabilities.
- *
- * Retains host-integration configuration/actions semantics: the module owns
- * the OAuth session lifecycle and bulk contact import pipeline contracts.
- * Runtime foreground transport (authentication headers, request context) and
- * all-capability composition remain in runtime/foreground.
- *
- * Allowed outbound capability dependencies: none (empty set). The integrations
- * module is a leaf capability that only depends on shared/ primitives.
- *
- * Compatibility path:
- * - capabilities/integrations.facade.ts — thin re-export via integrations/public
- */
-export * from "./public/index.js";

package/dist/negotiation/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * negotiation — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the negotiation
- * capability import directly from negotiation/domain, negotiation/application,
- * or negotiation/ports; this barrel is for cross-capability consumers that must
- * go through the negotiation public surface.
- *
- * IND-550: canonical home for the bilateral turn protocol, screening, memory,
- * consultation, settlement, and summary capabilities previously spread across
- * the flat negotiation/ directory and capabilities/negotiation*.facade.ts files.
- *
- * ## Module topology
- *
- * ```
- * negotiation/
- * ├── domain/       — pure types, protocol rules, policy functions, renderers
- * ├── application/  — LLM agents, LangGraph factory, MCP tool factory
- * ├── ports/        — injected dependency contracts (NegotiationToolDeps)
- * ├── public/       — curated re-export surface
- * └── index.ts      — this file
- * ```
- *
- */
-export * from "./public/index.js";

package/dist/negotiation/index.js

@@ -1,25 +0,0 @@
-/**
- * negotiation — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the negotiation
- * capability import directly from negotiation/domain, negotiation/application,
- * or negotiation/ports; this barrel is for cross-capability consumers that must
- * go through the negotiation public surface.
- *
- * IND-550: canonical home for the bilateral turn protocol, screening, memory,
- * consultation, settlement, and summary capabilities previously spread across
- * the flat negotiation/ directory and capabilities/negotiation*.facade.ts files.
- *
- * ## Module topology
- *
- * ```
- * negotiation/
- * ├── domain/       — pure types, protocol rules, policy functions, renderers
- * ├── application/  — LLM agents, LangGraph factory, MCP tool factory
- * ├── ports/        — injected dependency contracts (NegotiationToolDeps)
- * ├── public/       — curated re-export surface
- * └── index.ts      — this file
- * ```
- *
- */
-export * from "./public/index.js";

package/dist/opportunity/index.d.ts

@@ -1,29 +0,0 @@
-/**
- * opportunity — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the opportunity
- * capability import directly from opportunity/domain, opportunity/application,
- * or opportunity/ports; this barrel is for cross-capability consumers that must
- * go through the opportunity public surface.
- *
- * IND-551: canonical home for candidate generation, evaluation, persistence,
- * lifecycle, feed projection, evidence, outcome, and safe presentation.
- *
- * ## Module topology
- *
- * ```
- * opportunity/
- * ├── domain/       — pure types, predicates, policy, safe-presentation
- * ├── application/  — LLM agents, LangGraph graphs, effectful orchestration
- * ├── ports/        — injected dependency contracts
- * ├── public/       — curated re-export surface
- * └── index.ts      — this file
- * ```
- *
- * ## Subdirectories (domain and application files co-located)
- * - discriminator/ — pool question mining, scoring, assignment
- * - negotiation-evidence/ — Lens C evidence extraction and mining
- * - outcome/ — Lens B outcome hypothesis mining
- * - radar/ — radar graph (flat presenter-card list) and radar health
- */
-export * from "./public/index.js";

package/dist/opportunity/index.js

@@ -1,29 +0,0 @@
-/**
- * opportunity — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the opportunity
- * capability import directly from opportunity/domain, opportunity/application,
- * or opportunity/ports; this barrel is for cross-capability consumers that must
- * go through the opportunity public surface.
- *
- * IND-551: canonical home for candidate generation, evaluation, persistence,
- * lifecycle, feed projection, evidence, outcome, and safe presentation.
- *
- * ## Module topology
- *
- * ```
- * opportunity/
- * ├── domain/       — pure types, predicates, policy, safe-presentation
- * ├── application/  — LLM agents, LangGraph graphs, effectful orchestration
- * ├── ports/        — injected dependency contracts
- * ├── public/       — curated re-export surface
- * └── index.ts      — this file
- * ```
- *
- * ## Subdirectories (domain and application files co-located)
- * - discriminator/ — pool question mining, scoring, assignment
- * - negotiation-evidence/ — Lens C evidence extraction and mining
- * - outcome/ — Lens B outcome hypothesis mining
- * - radar/ — radar graph (flat presenter-card list) and radar health
- */
-export * from "./public/index.js";

package/dist/participant-agents/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * participant-agents — domain-first module root.
- *
- * Re-exports the curated public surface.  Other modules inside the
- * participant-agents capability import directly from
- * participant-agents/domain, participant-agents/application, or
- * participant-agents/ports; this barrel is for cross-capability consumers
- * that must go through the participant-agents public surface.
- *
- * IND-548: canonical home for agent registration, permission-aware behaviour,
- * and dispatch contracts.
- *
- * Compatibility path:
- * - shared/interfaces/agent-dispatcher.interface.ts — re-exports from
- *   participant-agents/ports
- */
-export * from "./public/index.js";

package/dist/participant-agents/index.js

@@ -1,17 +0,0 @@
-/**
- * participant-agents — domain-first module root.
- *
- * Re-exports the curated public surface.  Other modules inside the
- * participant-agents capability import directly from
- * participant-agents/domain, participant-agents/application, or
- * participant-agents/ports; this barrel is for cross-capability consumers
- * that must go through the participant-agents public surface.
- *
- * IND-548: canonical home for agent registration, permission-aware behaviour,
- * and dispatch contracts.
- *
- * Compatibility path:
- * - shared/interfaces/agent-dispatcher.interface.ts — re-exports from
- *   participant-agents/ports
- */
-export * from "./public/index.js";

package/dist/platform/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * platform — IND-543 outer shell.
- *
- * Curated contracts that are truly cross-domain: model primitives,
- * observability extension hooks, timeout/abort/request-context.
- *
- * Boundary: neutral-platform.  MUST NOT import any capability module
- * internals (signals, communities, opportunities, negotiation, …).
- * Permitted sources: shared/interfaces, shared/schemas, shared/observability,
- * shared/agent model + runtime helpers.
- *
- * These re-exports are temporary aliases; the implementation files remain in
- * shared/ until the domain migration issues land.
- */
-export { getModelName } from '../shared/agent/model.config.js';
-export { requestContext } from '../shared/observability/request-context.js';
-export { setLoggerFactory } from '../shared/observability/log.js';
-export { setTimingWrapper } from '../shared/observability/performance.js';
-export { getToolTimeoutPolicy, invokeToolRuntime, toolRuntimeErrorToResult, } from '../shared/agent/tool.runtime.js';

package/dist/platform/index.js

@@ -1,23 +0,0 @@
-/**
- * platform — IND-543 outer shell.
- *
- * Curated contracts that are truly cross-domain: model primitives,
- * observability extension hooks, timeout/abort/request-context.
- *
- * Boundary: neutral-platform.  MUST NOT import any capability module
- * internals (signals, communities, opportunities, negotiation, …).
- * Permitted sources: shared/interfaces, shared/schemas, shared/observability,
- * shared/agent model + runtime helpers.
- *
- * These re-exports are temporary aliases; the implementation files remain in
- * shared/ until the domain migration issues land.
- */
-// ── Model primitives ──────────────────────────────────────────────────────────
-export { getModelName } from '../shared/agent/model.config.js';
-// ── Request / abort context ───────────────────────────────────────────────────
-export { requestContext } from '../shared/observability/request-context.js';
-// ── Observability extension points ────────────────────────────────────────────
-export { setLoggerFactory } from '../shared/observability/log.js';
-export { setTimingWrapper } from '../shared/observability/performance.js';
-// ── Tool invocation runtime ───────────────────────────────────────────────────
-export { getToolTimeoutPolicy, invokeToolRuntime, toolRuntimeErrorToResult, } from '../shared/agent/tool.runtime.js';

package/dist/public/index.d.ts

@@ -1,17 +0,0 @@
-export {};
-/**
- * public — IND-543 outer shell.
- *
- * Curated root assembly and temporary compatibility aliases.  This shell will
- * eventually host a structured sub-barrel that feeds src/index.ts; during
- * the outer-seam phase (IND-543) it establishes the boundary and naming
- * convention without duplicating the existing root barrel.
- *
- * Boundary: public-compatibility.  May only reference capability contracts
- * via capabilities/*.facade.ts — never capability implementation internals.
- * Must not introduce a second supported package entry point; src/index.ts
- * remains the sole supported entry.
- *
- * Shell is intentionally declaration-only at this phase.  Curated re-exports
- * follow in subsequent issues once public/ is wired into src/index.ts.
- */

package/dist/public/index.js

@@ -1,17 +0,0 @@
-export {};
-/**
- * public — IND-543 outer shell.
- *
- * Curated root assembly and temporary compatibility aliases.  This shell will
- * eventually host a structured sub-barrel that feeds src/index.ts; during
- * the outer-seam phase (IND-543) it establishes the boundary and naming
- * convention without duplicating the existing root barrel.
- *
- * Boundary: public-compatibility.  May only reference capability contracts
- * via capabilities/*.facade.ts — never capability implementation internals.
- * Must not introduce a second supported package entry point; src/index.ts
- * remains the sole supported entry.
- *
- * Shell is intentionally declaration-only at this phase.  Curated re-exports
- * follow in subsequent issues once public/ is wired into src/index.ts.
- */

package/dist/questions/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * questions — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the questions
- * capability import directly from questions/domain, questions/application,
- * or questions/ports; this barrel is for cross-capability consumers that must
- * go through the questions public surface.
- *
- * IND-547: canonical home for question generation, eligibility, validation,
- * provenance, settlement policy, and continuation behaviour.
- *
- * Compatibility paths:
- * - capabilities/questions.facade.ts — re-exports from questions/public/index.js
- */
-export * from "./public/index.js";

package/dist/questions/index.js

@@ -1,15 +0,0 @@
-/**
- * questions — domain-first module root.
- *
- * Re-exports the curated public surface. Other modules inside the questions
- * capability import directly from questions/domain, questions/application,
- * or questions/ports; this barrel is for cross-capability consumers that must
- * go through the questions public surface.
- *
- * IND-547: canonical home for question generation, eligibility, validation,
- * provenance, settlement policy, and continuation behaviour.
- *
- * Compatibility paths:
- * - capabilities/questions.facade.ts — re-exports from questions/public/index.js
- */
-export * from "./public/index.js";

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

@@ -1,14 +0,0 @@
-export {};
-/**
- * runtime/background — IND-543 outer shell.
- *
- * Entry point for ambient / background workflow adapters: maintenance graphs,
- * enrichment runners, negotiation schedulers, and other non-interactive
- * entry points that operate without a live participant session.
- *
- * Boundary: ambient-background.  May import from any capability via its
- * capabilities/*.facade.ts contract.  Must not import host implementations.
- *
- * Shell is intentionally empty at this phase (IND-543 outer seam only).
- * Domain-level adapter relocations follow in subsequent issues.
- */

package/dist/runtime/background/index.js

@@ -1,14 +0,0 @@
-export {};
-/**
- * runtime/background — IND-543 outer shell.
- *
- * Entry point for ambient / background workflow adapters: maintenance graphs,
- * enrichment runners, negotiation schedulers, and other non-interactive
- * entry points that operate without a live participant session.
- *
- * Boundary: ambient-background.  May import from any capability via its
- * capabilities/*.facade.ts contract.  Must not import host implementations.
- *
- * Shell is intentionally empty at this phase (IND-543 outer seam only).
- * Domain-level adapter relocations follow in subsequent issues.
- */

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

@@ -1,17 +0,0 @@
-import { type ToolContext, type ResolvedToolContext } from "../../../shared/agent/tool.helpers.js";
-import type { OpportunityOwnerApprovalDeps } from "../../../opportunity/ports/opportunity.tools.port.js";
-export type { ToolContext, ResolvedToolContext, ProtocolDeps } from "../../../shared/agent/tool.helpers.js";
-export type { ToolDeps } from "../../../shared/agent/tool.helpers.js";
-/**
- * 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 declare function createChatTools(deps: ToolContext & OpportunityOwnerApprovalDeps, preResolvedContext?: ResolvedToolContext): Promise<any[]>;
-/**
- * Type for the tools array returned by createChatTools.
- */
-export type ChatTools = Awaited<ReturnType<typeof createChatTools>>;