@indexnetwork/protocol 13.2.0-rc.466.1 → 14.0.0-rc.468.1

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

@@ -1,4 +1,3 @@
-import { focusedIntentId } from "../shared/agent/tool.scope.js";
 // ═══════════════════════════════════════════════════════════════════════════════
 // EXTRACTION
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -7,7 +6,7 @@ import { focusedIntentId } from "../shared/agent/tool.scope.js";
  *
  * Scans backwards to find the last HumanMessage, then collects all tool calls
  * from AIMessages after that point. This ensures multi-iteration tool history
- * is available for module resolution within a single user turn.
+ * is available for prompt construction within a single user turn.
  *
  * @param messages - The current conversation message array
  * @returns Flattened array of tool name + args from the current agent turn
@@ -39,236 +38,3 @@ export function extractRecentToolCalls(messages) {
     }
     return toolCalls;
 }
-// ═══════════════════════════════════════════════════════════════════════════════
-// HELPERS
-// ═══════════════════════════════════════════════════════════════════════════════
-/**
- * Checks whether recent tool calls include discover_opportunities with
- * introduction-specific arguments (partyUserIds or introTargetUserId).
- */
-function hasIntroductionArgs(recentTools) {
-    return recentTools.some((t) => t.name === "discover_opportunities" &&
-        (t.args.partyUserIds || t.args.introTargetUserId));
-}
-// ═══════════════════════════════════════════════════════════════════════════════
-// MODULE DEFINITIONS
-// ═══════════════════════════════════════════════════════════════════════════════
-const intentCreationModule = {
-    id: "intent-creation",
-    triggers: ["create_intent"],
-    content: () => `
-### 2. User explicitly wants to create or save an intent
-
-**YOU decide if it's specific enough. The tool proposes — the user confirms.**
-
-\`\`\`
-IF description is vague ("find a job", "meet people", "learn something"):
-  1. read_user_contexts()           → get their background
-  2. read_intents()                 → see existing intents for context
-  3. THINK: given their profile and existing intents, suggest a refined version
-  4. Reply: "Based on your background in X, did you mean something like 'Y'?"
-  5. Wait for confirmation
-  6. On "yes" → create_intent(description=exact_refined_text)
-
-IF description is specific enough ("contribute to an open-source LLM project"):
-  → create_intent(description=...) directly
-\`\`\`
-
-**CRITICAL: Never write a \`\`\`intent_proposal block yourself.** To propose an intent you MUST call create_intent(description=...). The tool returns a \`\`\`intent_proposal code block (with proposalId and description). You MUST include that exact block verbatim in your response — it renders as an interactive card. Do not summarize or invent the block; only the tool provides a valid one. Add a brief explanation that creating this intent will let the system look for relevant people in the background.
-
-Specificity test: Does it contain a concrete domain, action, or scope? If just a single generic verb+noun ("find a job"), it's vague. If it has qualifying detail ("senior UX design role at a tech company in Berlin"), it's specific.
-`,
-};
-const intentManagementModule = {
-    id: "intent-management",
-    triggers: ["update_intent", "delete_intent"],
-    content: () => `
-### 4. Update or delete an intent
-
-**YOU look up the ID first.**
-
-\`\`\`
-1. read_intents() → get current intents with IDs
-2. Match user's request to the right intent
-3. update_intent(intentId=exact_id, description=...) or delete_intent(intentId=exact_id)
-\`\`\`
-`,
-};
-const personLookupModule = {
-    id: "person-lookup",
-    triggers: ["read_user_contexts"],
-    content: () => `
-### 0. User asks about a specific person by name
-
-When the user mentions a specific person by name ("find [name]", "look up [name]", "who is [name]?", "tell me about [name]"), look them up by name first — do NOT use discovery.
-
-- Call \`read_user_contexts(query="the name")\` — this finds members by name across the user's indexes
-- If one match: the result already includes their full profile; present it naturally
-- If multiple matches: present the list and ask the user to clarify which person
-- If no matches: tell the user you couldn't find anyone by that name in their network
-- If the user then asks for semantic discovery (e.g. "find people like them"), use Pattern 1.
-- If the user wants to connect with this specific person (e.g. "yes, connect us", "what can I do with them", "I'd like to reach out"), use Pattern 1a.
-`,
-};
-const urlScrapingModule = {
-    id: "url-scraping",
-    triggers: ["scrape_url"],
-    regex: /(https?:\/\/)/i,
-    content: (ctx) => `
-### 3. User includes a URL
-
-**YOU handle scraping before ${focusedIntentId(ctx) ? "updating the selected intent" : "intent creation"}.**
-
-\`\`\`
-1. scrape_url(url, objective="Extract key details for an intent")
-2. Synthesize a conceptual description from scraped content
-3. ${focusedIntentId(ctx) ? `update_intent(intentId="${focusedIntentId(ctx)}", description=synthesized_summary)` : "create_intent(description=synthesized_summary)"}
-\`\`\`
-
-Exception: for profile creation, pass URLs directly to create_user_context (it handles scraping internally).
-
-If the user pastes or types a profile URL (e.g. linkedin.com/..., github.com/...) to create or update their profile, you MUST pass that exact URL in the corresponding parameter (e.g. linkedinUrl, githubUrl, twitterUrl) to create_user_context, or use scrape_url with that URL then update_user_context; do not use the user's stored social links for that request.
-`,
-};
-const communityModule = {
-    id: "community",
-    triggers: ["read_networks", "create_network", "create_network_membership", "update_network", "delete_network", "delete_network_membership"],
-    content: () => `
-### 8. Explore what a community is about
-
-\`\`\`
-0. If user asks about communities they belong to, first use preloaded memberships in this prompt.
-1. read_networks() → get network details (title, prompt)
-2. read_intents(networkId=X) → what members are looking for
-3. read_network_memberships(networkId=X) → who's in it
-4. Synthesize: community purpose, active needs, member composition
-\`\`\`
-
-### When to mention community/index
-Index and community membership is background: handle it without talking about indexes unless the user asks or it's sign-up, leave, or owner settings. Do not proactively mention "your indexes", "your communities", "which index", "in your current communities", or similar. Only mention indexes (or communities, lists) when: (i) post-onboarding sign-up to a community, (ii) user explicitly asked about their indexes/communities, (iii) user wants to leave one, (iv) owner is changing index/community settings. Otherwise use neutral language ("where you're connected", "people you're connected with") and do not narrate "your indexes", "your current communities", "in this network", etc.
-`,
-};
-const contactsModule = {
-    id: "contacts",
-    triggers: ["import_gmail_contacts", "add_contact", "list_contacts", "remove_contact"],
-    // Gate on the CONTACTS_ENABLED flag (fail-closed: only `true` enables). When
-    // contacts are disabled the import/add tools are de-registered, so this module
-    // must not be injected — otherwise the orchestrator keeps advertising Gmail
-    // import / add_contact and offers an action that then fails as "Unknown tool".
-    triggerFilter: (iterCtx) => iterCtx.ctx.contactsEnabled === true,
-    content: () => `
-### 9. Import contacts from Gmail
-
-**Single-step workflow:**
-
-\`\`\`
-import_gmail_contacts()
-→ If not connected: returns { requiresAuth: true, authUrl: "..." } — share the URL with the user
-→ If connected: imports contacts directly and returns stats { imported, skipped, newContacts, existingContacts }
-\`\`\`
-
-Ghost users are contacts without accounts — they're enriched with public data (LinkedIn, GitHub, X) and can appear in opportunity discovery once enriched.
-
-### 10. Add or manage contacts manually
-
-\`\`\`
-# Add a single contact
-add_contact(email="alice@example.com", name="Alice Smith")
-
-# List user's network
-list_contacts() → returns contacts with names, emails, and whether they're ghost users
-
-# Remove a contact
-remove_contact(contactId=X)
-\`\`\`
-`,
-};
-const sharedContextModule = {
-    id: "shared-context",
-    triggers: ["read_network_memberships"],
-    content: () => `
-### 5. Find shared context between two users
-
-\`\`\`
-1. read_network_memberships(userId=me)     → my networks
-2. read_network_memberships(userId=other)  → their networks
-3. Intersect networkIds
-4. For each shared network: read_intents(networkId=shared)
-5. read_user_contexts(userId=other)
-6. Synthesize: what overlaps, where they could collaborate
-\`\`\`
-`,
-};
-const mentionsModule = {
-    id: "mentions",
-    triggers: [],
-    regex: /@\[.*?\]\(.*?\)/,
-    content: () => `- Messages may contain \`@[Display Name](userId)\` markup. The value in parentheses is the userId.
-`,
-};
-// ═══════════════════════════════════════════════════════════════════════════════
-// MODULE REGISTRY
-// ═══════════════════════════════════════════════════════════════════════════════
-/** All registered prompt modules. */
-export const PROMPT_MODULES = [
-    intentCreationModule,
-    intentManagementModule,
-    personLookupModule,
-    urlScrapingModule,
-    communityModule,
-    contactsModule,
-    sharedContextModule,
-    mentionsModule,
-];
-// ═══════════════════════════════════════════════════════════════════════════════
-// RESOLUTION
-// ═══════════════════════════════════════════════════════════════════════════════
-/**
- * Resolves which prompt modules should be injected for the current iteration.
- *
- * Phase 1: Skip all modules when onboarding is active (early exit).
- * Phase 2: Collect candidate modules by checking triggers and regex.
- * Phase 3: Apply exclusions (unidirectional — the excluding module stays).
- *
- * @param iterCtx - Current iteration context (tool history, user message, resolved context)
- * @returns Concatenated prompt text from all matched modules
- */
-export function resolveModules(iterCtx) {
-    // Phase 1 (early exit): Skip all modules during onboarding
-    if (iterCtx.ctx.isOnboarding) {
-        return "";
-    }
-    const toolNames = new Set(iterCtx.recentTools.map((t) => t.name));
-    // Phase 2: Collect candidates
-    const candidates = new Map();
-    for (const mod of PROMPT_MODULES) {
-        let matched = false;
-        // Check tool triggers (with optional filter for arg-based disambiguation)
-        if (mod.triggers.length > 0 && mod.triggers.some((t) => toolNames.has(t))) {
-            matched = mod.triggerFilter ? mod.triggerFilter(iterCtx) : true;
-        }
-        // Check regex trigger
-        if (!matched && mod.regex && iterCtx.currentMessage && mod.regex.test(iterCtx.currentMessage)) {
-            matched = true;
-        }
-        if (matched) {
-            candidates.set(mod.id, mod);
-        }
-    }
-    // Phase 3: Apply exclusions (skip self-exclusion)
-    for (const mod of candidates.values()) {
-        if (mod.excludes) {
-            for (const excludedId of mod.excludes) {
-                if (excludedId !== mod.id) {
-                    candidates.delete(excludedId);
-                }
-            }
-        }
-    }
-    // Build output
-    const sections = [];
-    for (const mod of candidates.values()) {
-        sections.push(mod.content(iterCtx.ctx));
-    }
-    return sections.join("\n");
-}

package/dist/chat/chat.streamer.js

@@ -1,6 +1,6 @@
 import { AIMessage, HumanMessage } from "@langchain/core/messages";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
-import { createAgentEndEvent, createAgentStartEvent, createDebugMetaEvent, createDecisionQuestionsEvent, createErrorEvent, createGraphEndEvent, createPhaseStartEvent, createPhaseEndEvent, createGraphStartEvent, createIterationStartEvent, createLlmStartEvent, createLlmEndEvent, createResponseCompleteEvent, createResponseResetEvent, createHallucinationDetectedEvent, createStatusEvent, createTokenEvent, createToolActivityEvent, createChatSummarizerStartEvent, createChatSummarizerEndEvent, createQuestionGeneratorStartEvent, createQuestionGeneratorEndEvent, createUserQuestionEvent } from "./chat-streaming.types.js";
+import { createAgentEndEvent, createAgentStartEvent, createDebugMetaEvent, createDecisionQuestionsEvent, createErrorEvent, createGraphEndEvent, createPhaseStartEvent, createPhaseEndEvent, createGraphStartEvent, createIterationStartEvent, createLlmStartEvent, createLlmEndEvent, createResponseCompleteEvent, createResponseResetEvent, createHallucinationDetectedEvent, createStatusEvent, createTokenEvent, createToolActivityEvent, createChatSummarizerStartEvent, createChatSummarizerEndEvent, createUserQuestionEvent } from "./chat-streaming.types.js";
 const logger = protocolLogger("ChatStreamer");
 // ══════════════════════════════════════════════════════════════════════════════
 // CHAT STREAMER (Streaming Narration Architecture)
@@ -176,12 +176,6 @@ export class ChatStreamer {
                     if (event.type === "chat_summarizer_end") {
                         yield createChatSummarizerEndEvent(sessionId, event.payload);
                     }
-                    if (event.type === "question_generator_start") {
-                        yield createQuestionGeneratorStartEvent(sessionId, event.payload);
-                    }
-                    if (event.type === "question_generator_end") {
-                        yield createQuestionGeneratorEndEvent(sessionId, event.payload);
-                    }
                 }
                 // ─────────────────────────────────────────────────────────────────
                 // UPDATES: final state from agentLoopNode
@@ -206,7 +200,7 @@ export class ChatStreamer {
                     if (debugMeta?.graph != null &&
                         typeof debugMeta.iterations === "number") {
                         const llmFallback = { calls: 0, totalDurationMs: 0, resets: [], hallucinations: [] };
-                        yield createDebugMetaEvent(sessionId, debugMeta.graph, debugMeta.iterations, Array.isArray(debugMeta.tools) ? debugMeta.tools : [], debugMeta.llm ?? llmFallback, debugMeta.orchestratorNegotiations, debugMeta.discoveryQuestions);
+                        yield createDebugMetaEvent(sessionId, debugMeta.graph, debugMeta.iterations, Array.isArray(debugMeta.tools) ? debugMeta.tools : [], debugMeta.llm ?? llmFallback, debugMeta.orchestratorNegotiations);
                     }
                     logger.verbose("Agent loop complete (updates)", {
                         responseLength: responseText.length,

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

@@ -4,10 +4,10 @@
  * Re-exports the stable contracts from domain, application, and ports.
  * Runtime adapter creation (graph factories, tool factories) is accessible
  * via capabilities/communities.facade.ts for package consumers and via the
- * foreground shell (runtime/foreground) for internal registries.
+ * tool composition root (shared/agent) for internal registries.
  *
  * Boundary: public-compatibility.  References only communities/domain,
- * communities/application, and communities/ports — never runtime/foreground
+ * communities/application, and communities/ports — never the tool composition root (shared/agent)
  * or host implementations.
  *
  * ## Intentionally excluded from public surface

package/dist/communities/public/index.js

@@ -4,10 +4,10 @@
  * Re-exports the stable contracts from domain, application, and ports.
  * Runtime adapter creation (graph factories, tool factories) is accessible
  * via capabilities/communities.facade.ts for package consumers and via the
- * foreground shell (runtime/foreground) for internal registries.
+ * tool composition root (shared/agent) for internal registries.
  *
  * Boundary: public-compatibility.  References only communities/domain,
- * communities/application, and communities/ports — never runtime/foreground
+ * communities/application, and communities/ports — never the tool composition root (shared/agent)
  * or host implementations.
  *
  * ## Intentionally excluded from public surface

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

@@ -8,7 +8,7 @@
  * ## Boundary
  *
  * References only contacts/domain, contacts/application, and contacts/ports.
- * Never imports from runtime/foreground, host implementations, or other
+ * Never imports from the tool composition root (shared/agent), host implementations, or other
  * capability internals.
  *
  * ## Intentionally excluded from public surface

package/dist/contacts/public/index.js

@@ -8,7 +8,7 @@
  * ## Boundary
  *
  * References only contacts/domain, contacts/application, and contacts/ports.
- * Never imports from runtime/foreground, host implementations, or other
+ * Never imports from the tool composition root (shared/agent), host implementations, or other
  * capability internals.
  *
  * ## Intentionally excluded from public surface

package/dist/index.d.ts

@@ -34,7 +34,7 @@ export type { NetworkAssignmentMetadata } from "./shared/schemas/network-assignm
 export { DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD, resolveAssignmentNetworkScope, buildNetworkAssignmentDecision } from "./shared/assignment/network-assignment.policy.js";
 export { buildCandidateEvidence } from "./capabilities/opportunities.facade.js";
 export { ChatGraphFactory } from "./capabilities/participant-agents.facade.js";
-export { ORCHESTRATOR_PERSONA_ID, type ChatPersonaConfig } from "./capabilities/participant-agents.facade.js";
+export { type ChatPersonaConfig } from "./capabilities/participant-agents.facade.js";
 export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "./capabilities/participant-agents.facade.js";
 export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_TOOL_NAMES, createSignalTools, filterSignalTools, narrowSignalTools, } from "./capabilities/participant-agents.facade.js";
 export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, REPORTER_TOOL_NAMES, createReporterTools, filterReporterTools, narrowReporterTools, } from "./capabilities/participant-agents.facade.js";

package/dist/index.js

@@ -30,7 +30,6 @@ export { DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD, resolveAssignmentNetworkScope, bu
 export { buildCandidateEvidence } from "./capabilities/opportunities.facade.js";
 // ─── Graph factories ──────────────────────────────────────────────────────────
 export { ChatGraphFactory } from "./capabilities/participant-agents.facade.js";
-export { ORCHESTRATOR_PERSONA_ID } from "./capabilities/participant-agents.facade.js";
 export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "./capabilities/participant-agents.facade.js";
 export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_TOOL_NAMES, createSignalTools, filterSignalTools, narrowSignalTools, } from "./capabilities/participant-agents.facade.js";
 export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, REPORTER_TOOL_NAMES, createReporterTools, filterReporterTools, narrowReporterTools, } from "./capabilities/participant-agents.facade.js";

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

@@ -8,7 +8,7 @@
  * ## Boundary
  *
  * References only integrations/domain, integrations/application, and
- * integrations/ports. Never imports from runtime/foreground, host
+ * integrations/ports. Never imports from the tool composition root (shared/agent), host
  * implementations, or other capability internals.
  *
  * ## Intentionally excluded from public surface

package/dist/integrations/public/index.js

@@ -8,7 +8,7 @@
  * ## Boundary
  *
  * References only integrations/domain, integrations/application, and
- * integrations/ports. Never imports from runtime/foreground, host
+ * integrations/ports. Never imports from the tool composition root (shared/agent), host
  * implementations, or other capability internals.
  *
  * ## Intentionally excluded from public surface

package/dist/mcp/mcp.server.d.ts

@@ -8,7 +8,7 @@ import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server';
 import type { JsonSchemaType } from '@modelcontextprotocol/server';
 import type { McpAuthResolver } from '../shared/interfaces/auth.interface.js';
 import type { ToolDeps, ResolvedToolContext, RawToolDefinition } from '../shared/agent/tool.helpers.js';
-import type { ToolRegistryDeps } from '../runtime/foreground/composition/tool.registry.js';
+import type { ToolRegistryDeps } from '../shared/agent/tool.registry.js';
 import type { McpAuthorizationObserver, McpCapabilityPolicyOptions } from './mcp.authorization-policy.js';
 /**
  * Static registration metadata for one MCP tool — schema conversion artifacts

package/dist/mcp/mcp.server.js

@@ -10,7 +10,7 @@ import { McpResolvedIdentitySchema } from '../shared/schemas/mcp-auth.schema.js'
 import { CANONICAL_GUIDANCE_SUMMARY } from '../shared/agent/canonical-guidance.js';
 import { resolveChatContext } from '../shared/agent/tool.helpers.js';
 import { deriveAllowedNetworkIds, scopeFromNetworkId } from '../shared/agent/tool.scope.js';
-import { createToolRegistry } from '../runtime/foreground/composition/tool.registry.js';
+import { createToolRegistry } from '../shared/agent/tool.registry.js';
 import { bindOwnerApprovalProvenance } from '../opportunity/application/opportunity.owner-provenance.js';
 import { ToolRuntimeError, invokeToolRuntime, toolRuntimeErrorToResult } from '../shared/agent/tool.runtime.js';
 import { protocolLogger } from '../shared/observability/protocol.logger.js';

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

@@ -6,7 +6,7 @@
  * ## Boundary
  *
  * References only negotiation/domain, negotiation/application, and
- * negotiation/ports. Never imports from runtime/foreground, host
+ * negotiation/ports. Never imports from the tool composition root (shared/agent), host
  * implementations, or other capability internals.
  *
  * ## Intentionally excluded from public surface

package/dist/negotiation/public/index.js

@@ -6,7 +6,7 @@
  * ## Boundary
  *
  * References only negotiation/domain, negotiation/application, and
- * negotiation/ports. Never imports from runtime/foreground, host
+ * negotiation/ports. Never imports from the tool composition root (shared/agent), host
  * implementations, or other capability internals.
  *
  * ## Intentionally excluded from public surface

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

@@ -9,7 +9,7 @@
  * ## Boundary
  *
  * References only participant-agents/domain, participant-agents/application,
- * and participant-agents/ports.  Never imports from runtime/foreground, host
+ * and participant-agents/ports.  Never imports from the tool composition root (shared/agent), host
  * implementations, or other capability internals.
  *
  * ## Intentionally excluded from public surface
@@ -17,7 +17,7 @@
  * The following are application-internal or runtime-owned:
  * - ChatGraphFactory, ChatPersonaConfig, ChatPersona — runtime graph wiring;
  *   consumers should import via capabilities/participant-agents.facade.ts.
- * - Persona constants (ORCHESTRATOR_PERSONA_ID, SIGNAL_PERSONA, etc.) — chat
+ * - Persona constants (SIGNAL_PERSONA, REPORTER_PERSONA, etc.) — chat
  *   runtime internals; import from capabilities/participant-agents.facade.ts.
  * - ChatTitleGenerator, ChatSummarizer, etc. — runtime tool composition; import
  *   via capabilities/participant-agents.facade.ts.

package/dist/participant-agents/public/index.js

@@ -9,7 +9,7 @@
  * ## Boundary
  *
  * References only participant-agents/domain, participant-agents/application,
- * and participant-agents/ports.  Never imports from runtime/foreground, host
+ * and participant-agents/ports.  Never imports from the tool composition root (shared/agent), host
  * implementations, or other capability internals.
  *
  * ## Intentionally excluded from public surface
@@ -17,7 +17,7 @@
  * The following are application-internal or runtime-owned:
  * - ChatGraphFactory, ChatPersonaConfig, ChatPersona — runtime graph wiring;
  *   consumers should import via capabilities/participant-agents.facade.ts.
- * - Persona constants (ORCHESTRATOR_PERSONA_ID, SIGNAL_PERSONA, etc.) — chat
+ * - Persona constants (SIGNAL_PERSONA, REPORTER_PERSONA, etc.) — chat
  *   runtime internals; import from capabilities/participant-agents.facade.ts.
  * - ChatTitleGenerator, ChatSummarizer, etc. — runtime tool composition; import
  *   via capabilities/participant-agents.facade.ts.

package/dist/participant-context/application/index.js

@@ -64,7 +64,7 @@ export { EnrichmentGraphFactory, } from "../../enrichment/enrichment.graph.js";
 export { EnrichmentGenerator } from "../../enrichment/enrichment.generator.js";
 export { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful, } from "../../enrichment/enrichment.enricher.js";
 // ── Tool factories (foreground adapters) ──────────────────────────────────────
-// These are foreground adapter entry points consumed by runtime/foreground
+// These are foreground adapter entry points consumed by the tool composition root (shared/agent)
 // composition.  They accept compiled graphs and host deps through the tool-dep
 // ports and produce LangChain-compatible tool arrays.
 export { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";

package/dist/participant-context/domain/index.d.ts

@@ -46,7 +46,7 @@
  * ## Policy separation
  *
  * - **Foreground adapters** (onboarding preview/confirm, explicit enrichment):
- *   managed by the foreground shell (runtime/foreground). They compose the
+ *   managed by the tool composition root (shared/agent). They compose the
  *   EnrichmentGraphFactory and PremiseGraphFactory and pass the compiled graphs
  *   through the tool-dependency ports.
  * - **Ambient adapters** (scrape/decompose, regeneration, indexing, representation

package/dist/participant-context/domain/index.js

@@ -46,7 +46,7 @@
  * ## Policy separation
  *
  * - **Foreground adapters** (onboarding preview/confirm, explicit enrichment):
- *   managed by the foreground shell (runtime/foreground). They compose the
+ *   managed by the tool composition root (shared/agent). They compose the
  *   EnrichmentGraphFactory and PremiseGraphFactory and pass the compiled graphs
  *   through the tool-dependency ports.
  * - **Ambient adapters** (scrape/decompose, regeneration, indexing, representation

package/dist/participant-context/public/index.d.ts

@@ -4,11 +4,11 @@
  * Re-exports the stable contracts from domain, application, and ports.
  * Runtime adapter creation (graph factories, tool factories) is accessible via
  * capabilities/participant-context.facade for package consumers and via
- * the foreground shell (runtime/foreground) for internal registries.
+ * the tool composition root (shared/agent) for internal registries.
  *
  * Boundary: public-compatibility.  References only participant-context/domain,
  * participant-context/application, and participant-context/ports — never
- * runtime/foreground or host implementations.
+ * the tool composition root (shared/agent) or host implementations.
  *
  * ## Intentionally excluded from public surface
  *

package/dist/participant-context/public/index.js

@@ -4,11 +4,11 @@
  * Re-exports the stable contracts from domain, application, and ports.
  * Runtime adapter creation (graph factories, tool factories) is accessible via
  * capabilities/participant-context.facade for package consumers and via
- * the foreground shell (runtime/foreground) for internal registries.
+ * the tool composition root (shared/agent) for internal registries.
  *
  * Boundary: public-compatibility.  References only participant-context/domain,
  * participant-context/application, and participant-context/ports — never
- * runtime/foreground or host implementations.
+ * the tool composition root (shared/agent) or host implementations.
  *
  * ## Intentionally excluded from public surface
  *

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

@@ -9,7 +9,7 @@
  * ## Boundary
  *
  * References only questions/domain, questions/application, and questions/ports.
- * Never imports from runtime/foreground, host implementations, or other
+ * Never imports from the tool composition root (shared/agent), host implementations, or other
  * capability internals.
  *
  * ## Intentionally excluded from public surface

package/dist/questions/public/index.js

@@ -9,7 +9,7 @@
  * ## Boundary
  *
  * References only questions/domain, questions/application, and questions/ports.
- * Never imports from runtime/foreground, host implementations, or other
+ * Never imports from the tool composition root (shared/agent), host implementations, or other
  * capability internals.
  *
  * ## Intentionally excluded from public surface

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

@@ -1,6 +1,17 @@
+import { type ToolContext, type ResolvedToolContext } from "./tool.helpers.js";
+import type { OpportunityOwnerApprovalDeps } from "../../opportunity/ports/opportunity.tools.port.js";
+export type { ToolContext, ResolvedToolContext, ProtocolDeps } from "./tool.helpers.js";
+export type { ToolDeps } from "./tool.helpers.js";
 /**
- * @deprecated Canonical location: runtime/foreground/composition/tool.factory
- * Retained for backward compatibility during IND-544 migration.
- * Import createChatTools from @indexnetwork/protocol instead.
+ * 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 { createChatTools, type ChatTools, type ToolContext, type ResolvedToolContext, type ProtocolDeps, type ToolDeps, } from "../../runtime/foreground/composition/tool.factory.js";
+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>>;