@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0-rc.604.2

package/dist/mcp/mcp.server.js

@@ -1,631 +0,0 @@
-/**
- * MCP Server Factory — creates an McpServer instance with all protocol tools
- * registered from the existing tool registry. Each tool invocation resolves
- * auth from the HTTP request, builds a ResolvedToolContext, and delegates
- * to the raw tool handler.
- */
-import { z } from 'zod';
-import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server';
-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 '../shared/agent/tool.registry.js';
-import { bindOwnerApprovalProvenance } from '../opportunities/opportunity.owner-provenance.js';
-import { ToolRuntimeError, invokeToolRuntime, toolRuntimeErrorToResult } from '../shared/agent/tool.runtime.js';
-import { protocolLogger } from '../shared/observability/protocol.logger.js';
-import { buildMcpAuthorizationDenialEvent, McpCapabilityPolicy, ONBOARDING_ALLOWED, resolveMcpActivityCaller, resolveMcpCapabilitySubject } from './mcp.authorization-policy.js';
-const logger = protocolLogger('McpServer');
-const mcpToolMetadataCache = new Map();
-/**
- * Builds a cache key from registry-shaping dependency booleans.
- * When a feature flag changes the tool set, the cache key changes so
- * the cached metadata set is automatically invalidated.
- */
-export function getMcpToolMetadataCacheKey(deps) {
-    // Contact tools are omitted from the MCP surface entirely (IND-596), so no
-    // contacts-related input can change the MCP tool set.
-    return [
-        `chat:${deps.chatSession ? '1' : '0'}`,
-        `agent:${deps.agentDatabase ? '1' : '0'}`,
-        `negotiation:${deps.agentDispatcher ? '1' : '0'}`,
-        `questioner:${deps.questionerEnqueue ? '1' : '0'}`,
-    ].join('|');
-}
-/**
- * Clears the metadata cache. Used in tests to ensure fresh state between cases.
- */
-export function clearMcpToolMetadataCacheForTests() {
-    mcpToolMetadataCache.clear();
-}
-/**
- * Returns cached (or builds and caches) static MCP tool registration metadata.
- * The first call per cache key runs the full registry creation + schema
- * conversion; subsequent calls return the cached metadata array for the same
- * registry-shaping dependency profile.
- *
- * Does NOT store tool handlers — those remain request-scoped because they
- * capture per-request userDb/systemDb.
- */
-export function getCachedMcpToolMetadata(deps) {
-    const cacheKey = getMcpToolMetadataCacheKey(deps);
-    const cached = mcpToolMetadataCache.get(cacheKey);
-    if (cached)
-        return cached;
-    const registry = createToolRegistry(deps, { surface: 'mcp' });
-    const metadata = Array.from(registry.values()).map((toolDef) => {
-        const jsonSchema = zodToJsonSchema(toolDef.schema);
-        return {
-            name: toolDef.name,
-            description: toolDef.description,
-            schema: toolDef.schema,
-            jsonSchema,
-            inputSchema: fromJsonSchema(jsonSchema),
-        };
-    });
-    mcpToolMetadataCache.set(cacheKey, metadata);
-    logger.verbose('MCP tool metadata cached', { toolCount: metadata.length, cacheKey });
-    return metadata;
-}
-function isExpectedMcpAuthError(message) {
-    return message.includes('Authentication required') ||
-        message.includes('Invalid API key') ||
-        message.includes('Invalid or expired access token') ||
-        message.includes('JWT payload missing user ID');
-}
-/**
- * Runtime/auth failures are converted into structured MCP `isError` tool
- * results for the caller. Reporting them as application exceptions produces
- * Sentry noise for expected client failures and policy-enforced timeouts.
- */
-export function shouldReportMcpToolError(err) {
-    if (err instanceof ToolRuntimeError)
-        return false;
-    const message = err instanceof Error ? err.message : String(err);
-    return !isExpectedMcpAuthError(message);
-}
-// ═══════════════════════════════════════════════════════════════════════════════
-// ZOD 3 → JSON SCHEMA CONVERSION
-// ═══════════════════════════════════════════════════════════════════════════════
-/**
- * Minimal Zod-to-JSON-Schema conversion for MCP tool registration.
- * Converts Zod 3.x schemas to plain JSON Schema objects that can be
- * wrapped with `fromJsonSchema()` for MCP SDK compatibility.
- */
-function zodToJsonSchema(schema) {
-    if (schema instanceof z.ZodObject) {
-        const shape = schema.shape;
-        const properties = {};
-        const required = [];
-        for (const [key, value] of Object.entries(shape)) {
-            const zodValue = value;
-            properties[key] = zodToJsonSchema(zodValue);
-            if (!(zodValue instanceof z.ZodOptional) && !(zodValue instanceof z.ZodDefault)) {
-                required.push(key);
-            }
-        }
-        return { type: 'object', properties, ...(required.length ? { required } : {}) };
-    }
-    if (schema instanceof z.ZodString) {
-        const result = { type: 'string' };
-        // Detect .url(), .email(), .uuid() etc. via Zod's internal checks array
-        const checks = schema._def?.checks;
-        if (checks) {
-            for (const check of checks) {
-                if (check.kind === 'url')
-                    result.format = 'uri';
-                else if (check.kind === 'email')
-                    result.format = 'email';
-                else if (check.kind === 'uuid')
-                    result.format = 'uuid';
-                else if (check.kind === 'datetime')
-                    result.format = 'date-time';
-            }
-        }
-        return result;
-    }
-    if (schema instanceof z.ZodNumber) {
-        const checks = schema._def?.checks;
-        const result = { type: 'number' };
-        if (checks) {
-            for (const check of checks) {
-                if (check.kind === 'int')
-                    result.type = 'integer';
-                else if (check.kind === 'min')
-                    result.minimum = check.value;
-                else if (check.kind === 'max')
-                    result.maximum = check.value;
-            }
-        }
-        return result;
-    }
-    if (schema instanceof z.ZodBoolean)
-        return { type: 'boolean' };
-    if (schema instanceof z.ZodArray) {
-        return { type: 'array', items: zodToJsonSchema(schema.element) };
-    }
-    if (schema instanceof z.ZodOptional) {
-        return zodToJsonSchema(schema.unwrap());
-    }
-    if (schema instanceof z.ZodDefault) {
-        return zodToJsonSchema(schema.removeDefault());
-    }
-    if (schema instanceof z.ZodEnum) {
-        return { type: 'string', enum: schema.options };
-    }
-    if (schema instanceof z.ZodNullable) {
-        const inner = zodToJsonSchema(schema.unwrap());
-        return { ...inner, nullable: true };
-    }
-    if (schema instanceof z.ZodRecord) {
-        return { type: 'object', additionalProperties: true };
-    }
-    return { type: 'object' };
-}
-// ═══════════════════════════════════════════════════════════════════════════════
-// RESULT POST-PROCESSING
-// ═══════════════════════════════════════════════════════════════════════════════
-/**
- * Strips internal `_`-prefixed keys from `data` and promotes `isError`
- * from the inner `success: false` signal to the MCP envelope level.
- * Fail-open: if JSON parsing throws, returns the original text with isError: false.
- */
-export function sanitizeMcpResult(text) {
-    try {
-        const parsed = JSON.parse(text);
-        if (parsed &&
-            typeof parsed === 'object' &&
-            parsed.data &&
-            typeof parsed.data === 'object' &&
-            !Array.isArray(parsed.data)) {
-            for (const key of Object.keys(parsed.data)) {
-                if (key.startsWith('_') || key === 'debugSteps') {
-                    delete parsed.data[key];
-                }
-            }
-        }
-        const isError = parsed?.success === false;
-        return { text: JSON.stringify(parsed), isError };
-    }
-    catch {
-        return { text, isError: false };
-    }
-}
-/**
- * Promotes a network-scoped agent's bound network into the resolved tool
- * context as the implicit chat scope. Every tool derives its focused network
- * from the `scopeType`/`scopeId` envelope; without this step scoped API-key
- * calls would still resolve an unscoped/global view.
- *
- * No-op when there is no scope, or when an explicit scope is already set
- * (a user-driven network-scoped chat must keep precedence over the agent
- * binding — which would be a strict subset anyway, since the API key cannot
- * reach beyond its bound network).
- */
-export const applyNetworkScopeToContext = (context, networkScopeId) => {
-    if (!networkScopeId)
-        return;
-    if (context.scopeType && context.scopeId)
-        return;
-    const scope = scopeFromNetworkId(networkScopeId);
-    context.scopeType = scope.scopeType;
-    context.scopeId = scope.scopeId;
-    const bound = context.userNetworks.find((m) => m.networkId === networkScopeId);
-    if (!bound)
-        return;
-    context.indexName = bound.networkTitle;
-    context.scopedIndex = {
-        id: bound.networkId,
-        title: bound.networkTitle,
-        prompt: bound.indexPrompt ?? null,
-    };
-    const isOwner = bound.permissions?.includes('owner') ?? false;
-    context.scopedMembershipRole = isOwner ? 'owner' : 'member';
-    context.isOwner = isOwner;
-};
-export { ONBOARDING_ALLOWED } from './mcp.authorization-policy.js';
-/**
- * Builds the onboarding gate message for REST Tool API callers. Condensed
- * from the chat onboarding flow into a 6-step tool-error guide. MCP does
- * not use this gate.
- */
-export function buildMcpOnboardingMessage(ctx) {
-    const nameStep = ctx.hasName
-        ? `1. Greet the user and confirm their name ("You're ${ctx.userName}, right?").`
-        : `1. Ask the user for their name and a short self-description.`;
-    const communityStep = ctx.networkId
-        ? `4. (Skipped — user is already in "${ctx.indexName ?? 'their community'}".)`
-        : `4. Call read_networks() and let the user pick communities to join via create_network_membership(networkId=...).`;
-    const allowedList = Array.from(ONBOARDING_ALLOWED).join(', ');
-    return (`This user has not completed onboarding. You must guide them through setup before they can use other tools. ` +
-        `Only the following tools are available until onboarding is complete: ` +
-        `${allowedList}.\n\n` +
-        `Onboarding flow:\n` +
-        `${nameStep}\n` +
-        `2. Call preview_user_context(...). If it returns profileRunId, poll get_enrichment_run(profileRunId=...) until status is succeeded, then use its result as the draft.\n` +
-        `3. Present the profile draft and ask "Does that look right?" On approval/correction, call confirm_user_context(...).\n` +
-        `${communityStep}\n` +
-        `5. Ask what the user is looking for and call create_intent(description="...", autoApprove=true) so the first signal is persisted.\n` +
-        `6. Call complete_onboarding() to finish setup. Discovery is optional after onboarding, never mandatory.`);
-}
-/**
- * Creates an MCP server with all protocol tools registered.
- * Tools resolve auth per-request via the HTTP request available in ServerContext.
- *
- * @param deps - Shared tool dependencies (graphs, database, embedder, etc.)
- * @param authResolver - Resolves authenticated identity from the HTTP request
- * @param scopedDepsFactory - Factory for creating per-request scoped databases
- * @returns A configured McpServer ready to be connected to a transport
- */
-function createMcpTraceEmitter(toolName, ctx) {
-    const token = ctx.mcpReq._meta?.progressToken;
-    if (typeof token !== 'string' && typeof token !== 'number')
-        return undefined;
-    let progress = 0;
-    return (event) => {
-        progress += 1;
-        const message = (() => {
-            if (event.type === 'graph_start')
-                return `${toolName}: ${event.name} started`;
-            if (event.type === 'graph_end')
-                return `${toolName}: ${event.name} finished${event.durationMs != null ? ` in ${event.durationMs}ms` : ''}`;
-            if (event.type === 'agent_start')
-                return `${toolName}: ${event.name} agent started`;
-            if (event.type === 'agent_end')
-                return `${toolName}: ${event.name} agent finished${event.durationMs != null ? ` in ${event.durationMs}ms` : ''}`;
-            return `${toolName}: progress`;
-        })();
-        const notification = {
-            method: 'notifications/progress',
-            params: { progressToken: token, progress, message },
-        };
-        void ctx.mcpReq.notify(notification).catch((err) => {
-            logger.debug('Failed to send MCP progress notification', {
-                toolName,
-                error: err instanceof Error ? err.message : String(err),
-            });
-        });
-    };
-}
-export const MCP_INSTRUCTIONS = `
-${CANONICAL_GUIDANCE_SUMMARY}
-
-# Voice & Output Rules
-Calm, analytical, concise. Say "signal" not "intent", "community" not "index". Never use "search" — use "discover" or "find". Banned: leverage, optimize, unlock, scale, disrupt, AI-powered, act fast.
-
-NEVER dump raw JSON or expose IDs (except actionable ones like conversationId). Synthesize in natural language; surface top 1–3 points unless asked for full list. Fabricate nothing.
-
-# Authentication & Opportunity Lifecycle
-API key in \`x-api-key\` header. Opportunities: draft → pending → accepted/rejected. Agent acceptance ≠ owner approval. Only call update_opportunity with accepted after explicit user confirmation.
-
-# Tool Guidance
-Read each tool's description for usage rules (when, prerequisites, follow-ups). Tools contain workflow patterns.
-
-`.trim();
-/**
- * Extracts a Bearer token from an HTTP Authorization header.
- */
-export function extractBearerToken(req) {
-    const authHeader = req.headers.get('Authorization');
-    if (!authHeader)
-        return undefined;
-    const [scheme, token] = authHeader.trim().split(/\s+/, 2);
-    if (scheme?.toLowerCase() === 'bearer' && token)
-        return token;
-    return undefined;
-}
-export function createMcpServer(deps, authResolver, scopedDepsFactory, policyOptions = {}, authorizationObserver) {
-    const server = new McpServer({ name: 'index-network', version: '1.0.0' }, { instructions: MCP_INSTRUCTIONS });
-    const toolMetadata = getCachedMcpToolMetadata(deps);
-    const capabilityPolicy = new McpCapabilityPolicy(policyOptions);
-    // Fail-closed authorization observability: emit a safe, secret-free denial
-    // event at the host boundary. Never let an observer failure change the
-    // decision or surface a credential — the denial stands regardless.
-    const observeDenial = (input) => {
-        if (!authorizationObserver)
-            return;
-        try {
-            authorizationObserver.onCapabilityDenied(buildMcpAuthorizationDenialEvent(input));
-        }
-        catch (err) {
-            logger.debug('MCP authorization observer threw — ignoring', {
-                toolName: input.toolName,
-                error: err instanceof Error ? err.message : String(err),
-            });
-        }
-    };
-    // Both snapshots are scoped to this MCP server/connection. Permission
-    // changes therefore apply only after the caller reconnects or refreshes
-    // its session. They are never shared with the static tool metadata cache,
-    // so a different server/principal cannot inherit decisions.
-    let authenticatedRequest;
-    let resolvedRequest;
-    const extractAuthInput = (httpReq) => ({
-        bearerToken: extractBearerToken(httpReq),
-        apiKey: httpReq.headers.get('x-api-key') ?? undefined,
-        telegramHandle: httpReq.headers.get('x-index-telegram-handle') ?? undefined,
-        telegramUsername: httpReq.headers.get('x-index-telegram-username') ?? undefined,
-    });
-    const getAuthenticatedRequest = (httpReq) => {
-        if (authenticatedRequest)
-            return authenticatedRequest;
-        authenticatedRequest = (async () => {
-            const identity = McpResolvedIdentitySchema.parse(await authResolver.resolveIdentity(extractAuthInput(httpReq)));
-            const agentRecord = identity.agentId
-                ? await deps.agentDatabase?.getAgentWithRelations(identity.agentId) ?? null
-                : null;
-            const agent = agentRecord
-                ? {
-                    id: agentRecord.id,
-                    ownerId: agentRecord.ownerId,
-                    type: agentRecord.type,
-                    status: agentRecord.status,
-                    permissions: agentRecord.permissions.map((permission) => ({
-                        agentId: permission.agentId,
-                        userId: permission.userId,
-                        scope: permission.scope,
-                        scopeId: permission.scopeId,
-                        actions: [...permission.actions],
-                    })),
-                }
-                : null;
-            return {
-                identity,
-                agent,
-                // This snapshot is sufficient to reject forged/hidden calls before
-                // resolving chat context.
-                preliminarySubject: resolveMcpCapabilitySubject({
-                    identity,
-                    agent,
-                }),
-            };
-        })();
-        return authenticatedRequest;
-    };
-    const getResolvedRequest = (httpReq) => {
-        if (resolvedRequest)
-            return resolvedRequest;
-        resolvedRequest = (async () => {
-            const authenticated = await getAuthenticatedRequest(httpReq);
-            const context = await resolveChatContext({
-                database: deps.database,
-                userId: authenticated.identity.userId,
-            });
-            context.isMcp = true;
-            if (authenticated.identity.agentId) {
-                context.agentId = authenticated.identity.agentId;
-            }
-            // Trusted provenance seam (IND-593): only the server-resolved session
-            // identity — never a caller-supplied field — marks a direct MCP owner
-            // interaction for the opportunity owner-approval boundary. The
-            // capability-local extension deliberately keeps this field out of the
-            // shared helper's negotiations/question cycle.
-            bindOwnerApprovalProvenance(context, {
-                surface: 'mcp',
-                sessionAuthenticated: authenticated.identity.isSessionAuth === true,
-            });
-            applyNetworkScopeToContext(context, authenticated.identity.networkScopeId);
-            const subject = resolveMcpCapabilitySubject({
-                identity: authenticated.identity,
-                agent: authenticated.agent,
-            });
-            // Bind the typed resolved caller context so tools with
-            // permission-projected output (read_activity_summary) can apply the
-            // centralized projection without re-deriving principal state.
-            context.mcpCaller = resolveMcpActivityCaller(subject);
-            return {
-                ...authenticated,
-                context,
-                subject,
-            };
-        })();
-        return resolvedRequest;
-    };
-    const capabilityDeniedResult = (_decision) => {
-        const message = 'This capability is not available to the authenticated principal. Reconnect or refresh the session after an administrator changes permissions.';
-        return {
-            content: [{
-                    type: 'text',
-                    text: JSON.stringify({
-                        error: 'Capability not authorized',
-                        code: 'MCP_CAPABILITY_DENIED',
-                        message,
-                    }),
-                }],
-            isError: true,
-        };
-    };
-    for (const toolDef of toolMetadata) {
-        const toolName = toolDef.name;
-        server.registerTool(toolName, {
-            description: toolDef.description,
-            inputSchema: toolDef.inputSchema,
-        }, async (args, ctx) => {
-            let reportDeps = deps;
-            let reportUserId;
-            let reportContext;
-            try {
-                // Extract the original HTTP request from the MCP server context
-                const httpReq = ctx.http?.req;
-                if (!httpReq) {
-                    return {
-                        content: [{ type: 'text', text: JSON.stringify({ error: 'No HTTP request available in MCP context' }) }],
-                        isError: true,
-                    };
-                }
-                // Resolve the request-local auth/agent snapshot, then repeat the exact
-                // tools/list policy decision before chat context, scoped DB, registry,
-                // or handler work. This is the forged-call fail-closed boundary.
-                const authenticated = await getAuthenticatedRequest(httpReq);
-                const preliminaryDecision = capabilityPolicy.authorize(authenticated.preliminarySubject, toolName);
-                if (!preliminaryDecision.allowed) {
-                    observeDenial({
-                        phase: 'tools/call',
-                        toolName,
-                        subject: authenticated.preliminarySubject,
-                        decision: preliminaryDecision,
-                    });
-                    return capabilityDeniedResult(preliminaryDecision);
-                }
-                const resolved = await getResolvedRequest(httpReq);
-                const decision = capabilityPolicy.authorize(resolved.subject, toolName);
-                if (!decision.allowed) {
-                    observeDenial({
-                        phase: 'tools/call',
-                        toolName,
-                        subject: resolved.subject,
-                        decision,
-                    });
-                    return capabilityDeniedResult(decision);
-                }
-                const { identity, context } = resolved;
-                const { userId, agentId } = identity;
-                reportUserId = userId;
-                // Per-principal MCP throttle. Runs BEFORE any DB work so a throttled
-                // call short-circuits cheaply. The /mcp transport bypasses the
-                // controller-level RateLimit guard, so this is the only volume cap on
-                // tool calls — it stops an over-eager agent from cascading itself into
-                // provider rate limits.
-                if (deps.mcpRateLimiter) {
-                    // Throttling is best-effort: never let a limiter failure (or a host
-                    // implementation that throws instead of failing open) break tool
-                    // dispatch. Treat any error as "allowed".
-                    let decision = null;
-                    try {
-                        decision = await deps.mcpRateLimiter({
-                            userId,
-                            ...(agentId ? { agentId } : {}),
-                            toolName,
-                        });
-                    }
-                    catch (rlErr) {
-                        logger.warn('MCP rate limiter threw — failing open', {
-                            toolName,
-                            error: rlErr instanceof Error ? rlErr.message : String(rlErr),
-                        });
-                    }
-                    if (decision && !decision.allowed) {
-                        const retryAfterSec = decision.retryAfterSec ?? 60;
-                        return {
-                            content: [{
-                                    type: 'text',
-                                    text: JSON.stringify({
-                                        error: 'Rate limit exceeded',
-                                        message: `Too many ${toolName} calls in a short period. Wait ${retryAfterSec}s before retrying.`,
-                                        retryAfterSec,
-                                    }),
-                                }],
-                            isError: true,
-                        };
-                    }
-                }
-                reportContext = context;
-                // Build per-request scoped databases via injected factory.
-                // Network-scoped agents are clamped to their bound network plus the user's
-                // personal network — they cannot reach other networks even when the user is
-                // a member of them. The personal-index reachability is preserved so the
-                // agent can still manage its owner's profile and contacts.
-                const allowedNetworkIds = deriveAllowedNetworkIds({
-                    memberships: context.userNetworks,
-                    ...(context.scopeType && context.scopeId
-                        ? { scopeType: context.scopeType, scopeId: context.scopeId }
-                        : {}),
-                });
-                const scopedDbs = scopedDepsFactory.create(userId, allowedNetworkIds);
-                // Override deps with per-request scoped databases
-                const requestDeps = { ...deps, ...scopedDbs };
-                reportDeps = requestDeps;
-                // Re-create registry with per-request deps for scoped database access.
-                // Do not use cached registration metadata handlers here: tool handlers
-                // close over userDb/systemDb when the registry is created. The MCP
-                // surface profile keeps the tools/call lookup identical to tools/list.
-                const requestRegistry = createToolRegistry(requestDeps, { surface: 'mcp' });
-                const requestTool = requestRegistry.get(toolName);
-                if (!requestTool) {
-                    return {
-                        content: [{ type: 'text', text: JSON.stringify({ error: `Tool "${toolName}" not found` }) }],
-                        isError: true,
-                    };
-                }
-                // Validate input against the original Zod schema
-                const parseResult = toolDef.schema.safeParse(args);
-                if (!parseResult.success) {
-                    const issues = parseResult.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');
-                    return {
-                        content: [{ type: 'text', text: JSON.stringify({ success: false, error: `Invalid input: ${issues}` }) }],
-                        isError: true,
-                    };
-                }
-                const validatedArgs = parseResult.data;
-                // Execute the tool handler through the shared runtime so MCP calls have
-                // consistent timeout, cancellation, progress, and requestContext plumbing.
-                const result = await invokeToolRuntime({
-                    toolName,
-                    tool: requestTool,
-                    context,
-                    query: validatedArgs,
-                    signal: ctx.mcpReq.signal,
-                    traceEmitter: createMcpTraceEmitter(toolName, ctx),
-                });
-                const { text: sanitizedText, isError: toolIsError } = sanitizeMcpResult(result);
-                return {
-                    content: [{ type: 'text', text: sanitizedText }],
-                    ...(toolIsError ? { isError: true } : {}),
-                };
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : String(err);
-                logger.error('MCP tool failed', { toolName, error: message });
-                if (shouldReportMcpToolError(err)) {
-                    reportDeps.reportToolError?.(err, {
-                        subsystem: 'mcp',
-                        operation: 'mcp.tool',
-                        toolName,
-                        userId: reportUserId,
-                        tags: {
-                            transport: 'mcp',
-                            toolName,
-                        },
-                        context: {
-                            agentId: reportContext?.agentId,
-                            scopeType: reportContext?.scopeType,
-                            scopeId: reportContext?.scopeId,
-                        },
-                    });
-                }
-                const runtimeResult = toolRuntimeErrorToResult(err);
-                return {
-                    content: [{ type: 'text', text: runtimeResult ?? JSON.stringify({ error: message }) }],
-                    isError: true,
-                };
-            }
-        });
-    }
-    // McpServer's default tools/list handler exposes every registered tool.
-    // Replace it with a principal-aware inventory built from the same static
-    // metadata and the same policy used above for tools/call.
-    server.server.setRequestHandler('tools/list', async (_request, ctx) => {
-        const httpReq = ctx.http?.req;
-        if (!httpReq) {
-            throw new Error('No HTTP request available in MCP context');
-        }
-        const resolved = await getResolvedRequest(httpReq);
-        const visibleNames = new Set(capabilityPolicy.visibleToolNames(resolved.subject, toolMetadata.map((tool) => tool.name)));
-        return {
-            tools: toolMetadata
-                .filter((tool) => visibleNames.has(tool.name))
-                .map((tool) => ({
-                name: tool.name,
-                description: tool.description,
-                // `jsonSchema` is the zod-derived JSON Schema for the tool's object
-                // input, so it always has `type: 'object'`. The SDK describes the same
-                // value with two different types — `JsonSchemaType` (json-schema-typed,
-                // used by `fromJsonSchema`) and the wire-level `Tool['inputSchema']` —
-                // which are structurally incompatible, so bridge them at this boundary.
-                inputSchema: tool.jsonSchema,
-            })),
-        };
-    });
-    logger.verbose('MCP server created', { toolCount: toolMetadata.length });
-    return server;
-}

package/dist/negotiations/insight.generator.d.ts

@@ -1,31 +0,0 @@
-/**
- * Negotiation Insights Generator
- *
- * Produces an aggregated, second-person narrative summarizing a user's
- * negotiation history — topics they're sought for, role patterns,
- * opportunity trends, and interesting signals from recent activity.
- */
-/** Compressed digest of a user's negotiation history for the LLM. */
-export interface NegotiationDigest {
-    totalCount: number;
-    opportunityCount: number;
-    noOpportunityCount: number;
-    inProgressCount: number;
-    roleDistribution: Record<string, number>;
-    counterparties: string[];
-    reasoningExcerpts: string[];
-}
-/**
- * Generates an aggregated insight summary from a user's negotiation history.
- * @remarks Lightweight single-call agent; no DB access, no side effects.
- */
-export declare class NegotiationInsightsGenerator {
-    private model;
-    constructor();
-    /**
-     * Produces a narrative summary from a negotiation digest.
-     * @param digest - Pre-computed statistics and excerpts from the user's negotiations
-     * @returns A 2-4 sentence insight paragraph, or null on failure
-     */
-    invoke(digest: NegotiationDigest): Promise<string | null>;
-}