@peernova/cuneiform-sf 1.0.3-beta.0 → 1.0.4-beta.8

package/lib/mcp/tools/object-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/object-tools.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/org-tools.d.ts

@@ -0,0 +1,14 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import { type OrgDetailsInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_org_details tool invocation.
+ *
+ * Routes by section parameter to return one section per call,
+ * keeping responses within LLM context budgets (~3 KB max).
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleOrgDetails(adapters: McpAdapters, params: OrgDetailsInput): Promise<CallToolResult>;

package/lib/mcp/tools/org-tools.js

@@ -0,0 +1,177 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { OrgInfoService } from '../../services/OrgInfoService.js';
+import { decodeCursor, clampPageSize, createPaginationMetadata, PAGE_SIZE_DEFAULTS } from '../config/pagination.js';
+import { McpErrorCodes } from '../errors.js';
+import { ORG_DETAILS_SECTIONS } from '../schemas/input-schemas.js';
+import { serviceResultToMcp, serviceResultToMcpPaginated, createMcpError, extractErrorMessage, } from './tool-factory.js';
+/**
+ * Handles the identity section — org identity with available sections list.
+ */
+async function handleIdentitySection(orgInfoService, facade) {
+    const result = await orgInfoService.getOrgIdentity();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const identity = result.data;
+    const orgType = OrgInfoService.classifyOrgType(identity.isSandbox, identity.organizationType);
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            orgId: identity.organizationId,
+            orgName: identity.organizationName ?? null,
+            orgType,
+            edition: identity.organizationType ?? null,
+            namespace: identity.namespacePrefix ?? null,
+            instanceUrl: facade.instanceUrl ?? null,
+            username: identity.username,
+            availableSections: [...ORG_DETAILS_SECTIONS],
+        },
+        message: `Org identity for ${identity.organizationName ?? identity.organizationId}`,
+    });
+}
+/**
+ * Handles the cuneiform section — package installation status.
+ */
+async function handleCuneiformSection(orgInfoService) {
+    const result = await orgInfoService.getCuneiformPackageInfo();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            installed: result.data.installed,
+            version: result.data.version ?? null,
+            licenseStatus: result.data.licenseStatus,
+        },
+        message: 'Cuneiform package info retrieved',
+    });
+}
+/**
+ * Handles the features section — detected org features.
+ */
+async function handleFeaturesSection(orgInfoService) {
+    const result = await orgInfoService.getOrgFeatures();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    return serviceResultToMcp({
+        success: true,
+        data: result.data,
+        message: 'Org features retrieved',
+    });
+}
+/**
+ * Handles the clouds section — detected Salesforce clouds with pagination.
+ */
+async function handleCloudsSection(orgInfoService, cursor, limit) {
+    const offset = decodeCursor(cursor);
+    const pageSize = clampPageSize(limit, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.default, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.max);
+    const result = await orgInfoService.getDetectedClouds();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const allClouds = result.data;
+    const page = allClouds.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: allClouds.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({ success: true, data: page, message: 'Detected clouds retrieved' }, pagination);
+}
+/**
+ * Handles the namespaces section — installed namespaces with pagination.
+ */
+async function handleNamespacesSection(orgInfoService, cursor, limit) {
+    const offset = decodeCursor(cursor);
+    const pageSize = clampPageSize(limit, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.default, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.max);
+    const result = await orgInfoService.getInstalledNamespaces();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const allNamespaces = result.data.namespaces;
+    const page = allNamespaces.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: allNamespaces.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({
+        success: true,
+        data: { count: allNamespaces.length, namespaces: page },
+        message: `Installed namespaces retrieved (${allNamespaces.length} total)`,
+    }, pagination);
+}
+/**
+ * Handles the limits section — org API limits.
+ */
+async function handleLimitsSection(orgInfoService) {
+    const result = await orgInfoService.getOrgLimits();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const limits = result.data;
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            dailyApiRequests: limits.dailyApiRequests ?? null,
+            dataStorageMB: limits.dataStorageMB ?? null,
+            fileStorageMB: limits.fileStorageMB ?? null,
+            dailyBulkApiRequests: limits.dailyBulkApiRequests ?? null,
+            dailyBulkV2QueryJobs: limits.dailyBulkV2QueryJobs ?? null,
+            dailyAsyncApexExecutions: limits.dailyAsyncApexExecutions ?? null,
+            dailyStreamingApiEvents: limits.dailyStreamingApiEvents ?? null,
+        },
+        message: 'Org limits retrieved',
+    });
+}
+/**
+ * Handler for cuneiform_org_details tool invocation.
+ *
+ * Routes by section parameter to return one section per call,
+ * keeping responses within LLM context budgets (~3 KB max).
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleOrgDetails(adapters, params) {
+    try {
+        const { facade, soql: soqlAdapter, tooling: toolingAdapter, rest: restAdapter } = adapters;
+        const orgInfoService = new OrgInfoService({
+            connectionFacade: facade,
+            soqlAdapter,
+            toolingAdapter,
+            restAdapter,
+        });
+        switch (params.section) {
+            case 'identity':
+                return await handleIdentitySection(orgInfoService, facade);
+            case 'cuneiform':
+                return await handleCuneiformSection(orgInfoService);
+            case 'features':
+                return await handleFeaturesSection(orgInfoService);
+            case 'clouds':
+                return await handleCloudsSection(orgInfoService, params.cursor, params.limit);
+            case 'namespaces':
+                return await handleNamespacesSection(orgInfoService, params.cursor, params.limit);
+            case 'limits':
+                return await handleLimitsSection(orgInfoService);
+            default:
+                return createMcpError(McpErrorCodes.INVALID_TOOL_INPUT, `Unknown section: ${String(params.section)}`);
+        }
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to get org details: ${extractErrorMessage(error, 'handleOrgDetails')}`);
+    }
+}
+//# sourceMappingURL=org-tools.js.map

package/lib/mcp/tools/org-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/org-tools.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/profile-tools.d.ts

@@ -0,0 +1,59 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import type { ProfileExecuteInput, ProfileStatusInput, ProfileCancelInput, ProfileDeleteInput, RequestListInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_request_list tool invocation.
+ *
+ * Lists profiling requests with optional status filtering and pagination.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleRequestList(adapters: McpAdapters, params: RequestListInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_execute tool invocation.
+ *
+ * Executes profiling for a definition and optionally waits for completion.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleProfileExecute(adapters: McpAdapters, params: ProfileExecuteInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_status tool invocation.
+ *
+ * Retrieves status for one or more profiling requests in parallel.
+ * Not-found IDs are surfaced as a "Not Found" row — no hard error.
+ * Other service errors (e.g. SOQL failure) propagate as hard errors.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult with statuses array and summary counts
+ */
+export declare function handleProfileStatus(adapters: McpAdapters, params: ProfileStatusInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_cancel tool invocation.
+ *
+ * Cancels profiling jobs by request ID (single cancellation) or definition ID
+ * (bulk cancellation — queries active requests for the definition, then cancels them).
+ *
+ * Uses ProfileRequestService directly instead of the ProfilingExecutionService facade.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleProfileCancel(adapters: McpAdapters, params: ProfileCancelInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_delete tool invocation.
+ *
+ * Deletes terminal (Canceled) profiling requests by ID. This operation is irreversible.
+ * Only requests in the Canceled state can be deleted — the service enforces this constraint.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleProfileDelete(adapters: McpAdapters, params: ProfileDeleteInput): Promise<CallToolResult>;

package/lib/mcp/tools/profile-tools.js

@@ -0,0 +1,213 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { ProfilingDefinitionService } from '../../services/ProfilingDefinitionService.js';
+import { ProfilingExecutionService } from '../../services/ProfilingExecutionService.js';
+import { ProfileRequestService } from '../../services/ProfileRequestService.js';
+import { ServiceErrorCodes } from '../../adapters/errors.js';
+import { McpErrorCodes } from '../errors.js';
+import { serviceResultToMcp, createMcpError, extractErrorMessage } from './tool-factory.js';
+/**
+ * Handler for cuneiform_request_list tool invocation.
+ *
+ * Lists profiling requests with optional status filtering and pagination.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleRequestList(adapters, params) {
+    try {
+        const profileRequestService = new ProfileRequestService({
+            soqlAdapter: adapters.soql,
+            restAdapter: adapters.rest,
+        });
+        const result = await profileRequestService.listRequests({
+            status: params.status,
+            limit: params.limit,
+            offset: params.offset,
+        });
+        return serviceResultToMcp(result);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to list profiling requests: ${extractErrorMessage(error, 'handleRequestList')}`);
+    }
+}
+/**
+ * Handler for cuneiform_profile_execute tool invocation.
+ *
+ * Executes profiling for a definition and optionally waits for completion.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleProfileExecute(adapters, params) {
+    try {
+        const { soql: soqlAdapter, rest: restAdapter } = adapters;
+        const definitionService = new ProfilingDefinitionService({
+            soqlAdapter,
+            restAdapter,
+        });
+        // Build polling config if custom timeout provided
+        const pollingConfig = params.timeoutMs ? { timeoutMs: params.timeoutMs } : undefined;
+        // Initialize ProfilingExecutionService
+        const executionService = new ProfilingExecutionService({
+            restAdapter,
+            soqlAdapter,
+            profilingDefinitionService: definitionService,
+            pollingConfig,
+        });
+        // Execute profiling
+        const executeResult = await executionService.execute(params.definitionId);
+        if (!executeResult.success) {
+            return serviceResultToMcp(executeResult);
+        }
+        const requestId = executeResult.data;
+        // If wait=false, return immediately with request ID
+        if (!params.wait) {
+            return serviceResultToMcp({
+                success: true,
+                data: {
+                    requestId,
+                    status: 'Queued',
+                    definitionId: params.definitionId,
+                    success: null, // Pending
+                    message: 'Profiling request enqueued. Use cuneiform_profile_status to check progress.',
+                },
+                message: executeResult.message,
+                metadata: executeResult.metadata,
+            });
+        }
+        // Wait for completion
+        const completionResult = await executionService.waitForCompletion(requestId);
+        return serviceResultToMcp(completionResult);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to execute profiling: ${extractErrorMessage(error, 'handleProfileExecute')}`);
+    }
+}
+/**
+ * Handler for cuneiform_profile_status tool invocation.
+ *
+ * Retrieves status for one or more profiling requests in parallel.
+ * Not-found IDs are surfaced as a "Not Found" row — no hard error.
+ * Other service errors (e.g. SOQL failure) propagate as hard errors.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult with statuses array and summary counts
+ */
+export async function handleProfileStatus(adapters, params) {
+    try {
+        const executionService = new ProfilingExecutionService({
+            restAdapter: adapters.rest,
+            soqlAdapter: adapters.soql,
+        });
+        const statusEntries = await Promise.all(params.requestIds.map(async (requestId) => {
+            const result = await executionService.getStatus(requestId);
+            if (result.success) {
+                return result.data;
+            }
+            if (result.errorCode === ServiceErrorCodes.PROFILING_REQUEST_NOT_FOUND) {
+                return { requestId, status: 'Not Found', definitionId: '' };
+            }
+            throw new Error(result.message ?? `Status check failed for ${requestId}`);
+        }));
+        const summary = {
+            completed: statusEntries.filter((s) => s.status === 'Completed').length,
+            inProgress: statusEntries.filter((s) => s.status === 'Queued').length,
+            failed: statusEntries.filter((s) => s.status === 'Rejected' || s.status === 'Canceled').length,
+            notFound: statusEntries.filter((s) => s.status === 'Not Found').length,
+        };
+        return serviceResultToMcp({
+            success: true,
+            data: { statuses: statusEntries, summary },
+            message: `${statusEntries.length} request(s) checked — ${summary.completed} completed, ${summary.inProgress} in progress, ${summary.failed} failed, ${summary.notFound} not found`,
+        });
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to get profiling status: ${extractErrorMessage(error, 'handleProfileStatus')}`);
+    }
+}
+/**
+ * Handler for cuneiform_profile_cancel tool invocation.
+ *
+ * Cancels profiling jobs by request ID (single cancellation) or definition ID
+ * (bulk cancellation — queries active requests for the definition, then cancels them).
+ *
+ * Uses ProfileRequestService directly instead of the ProfilingExecutionService facade.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleProfileCancel(adapters, params) {
+    try {
+        const profileRequestService = new ProfileRequestService({
+            soqlAdapter: adapters.soql,
+            restAdapter: adapters.rest,
+        });
+        // Execute appropriate method based on input mode
+        if (params.requestId) {
+            // Single request cancellation via ProfileRequestService
+            const result = await profileRequestService.cancelRequests({ requestIds: [params.requestId] });
+            return serviceResultToMcp(result);
+        }
+        else if (params.definitionId) {
+            // Definition-wide cancellation: list all cancellable requests for the definition,
+            // then cancel them via ProfileRequestService
+            const listResult = await profileRequestService.listRequests({ status: ['Queued'] });
+            if (!listResult.success) {
+                return serviceResultToMcp(listResult);
+            }
+            // Filter to requests belonging to this definition
+            const definitionRequests = listResult.data.filter((r) => r.definitionId === params.definitionId);
+            if (definitionRequests.length === 0) {
+                return serviceResultToMcp({
+                    success: true,
+                    data: 0,
+                    message: 'No active requests to cancel for this definition',
+                    metadata: { duration: 0 },
+                });
+            }
+            const requestIds = definitionRequests.map((r) => r.id);
+            const cancelResult = await profileRequestService.cancelRequests({ requestIds });
+            return serviceResultToMcp(cancelResult);
+        }
+        else {
+            return createMcpError(McpErrorCodes.INVALID_TOOL_INPUT, 'Either requestId or definitionId must be provided');
+        }
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to cancel profiling: ${extractErrorMessage(error, 'handleProfileCancel')}`);
+    }
+}
+/**
+ * Handler for cuneiform_profile_delete tool invocation.
+ *
+ * Deletes terminal (Canceled) profiling requests by ID. This operation is irreversible.
+ * Only requests in the Canceled state can be deleted — the service enforces this constraint.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleProfileDelete(adapters, params) {
+    try {
+        const profileRequestService = new ProfileRequestService({
+            soqlAdapter: adapters.soql,
+            restAdapter: adapters.rest,
+        });
+        const result = await profileRequestService.deleteRequests({ requestIds: params.requestIds });
+        return serviceResultToMcp(result);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to delete profiling requests: ${extractErrorMessage(error, 'handleProfileDelete')}`);
+    }
+}
+//# sourceMappingURL=profile-tools.js.map

package/lib/mcp/tools/profile-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/profile-tools.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/summary-tools.d.ts

@@ -0,0 +1,14 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import type { SummaryListInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_summary_list tool invocation.
+ *
+ * Retrieves profiling summary statistics for a specific definition ID.
+ * Supports pagination via limit and offset parameters.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult containing ProfilingSummary[] or error
+ */
+export declare function handleSummaryList(adapters: McpAdapters, params: SummaryListInput): Promise<CallToolResult>;

package/lib/mcp/tools/summary-tools.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { ProfilingSummaryService } from '../../services/ProfilingSummaryService.js';
+import { McpErrorCodes } from '../errors.js';
+import { serviceResultToMcp, createMcpError, extractErrorMessage } from './tool-factory.js';
+/**
+ * Handler for cuneiform_summary_list tool invocation.
+ *
+ * Retrieves profiling summary statistics for a specific definition ID.
+ * Supports pagination via limit and offset parameters.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult containing ProfilingSummary[] or error
+ */
+export async function handleSummaryList(adapters, params) {
+    try {
+        const summaryService = new ProfilingSummaryService({
+            soqlAdapter: adapters.soql,
+        });
+        // Get summaries with pagination
+        const result = await summaryService.getSummaries({
+            definitionId: params.definitionId,
+            limit: params.limit,
+            offset: params.offset,
+        });
+        return serviceResultToMcp(result);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to list summaries: ${extractErrorMessage(error, 'handleSummaryList')}`);
+    }
+}
+//# sourceMappingURL=summary-tools.js.map

package/lib/mcp/tools/summary-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/summary-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5F;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAqB,EAAE,MAAwB;IACrF,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,IAAI,uBAAuB,CAAC;YACjD,WAAW,EAAE,QAAQ,CAAC,IAAI;SAC3B,CAAC,CAAC;QAEH,gCAAgC;QAChC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC;YAC/C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CACnB,aAAa,CAAC,sBAAsB,EACpC,6BAA6B,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/mcp/tools/tool-factory.d.ts

@@ -0,0 +1,63 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ServiceResult } from '../../models/service-result.js';
+import type { PaginationMetadata } from '../config/pagination.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import { type McpErrorCode } from '../errors.js';
+/**
+ * Creates a typed MCP tool handler that narrows `unknown` input to type `T`.
+ *
+ * The McpServer SDK validates input via Zod schemas before calling handlers,
+ * so the cast from `unknown` to `T` is runtime-safe. This wrapper centralizes
+ * the single cast point instead of scattering `input as T` across 18 handlers.
+ *
+ * @template T The validated input type (inferred from the handler parameter)
+ * @param handler - Typed handler function accepting validated input
+ * @returns Untyped handler matching the ToolHandler signature
+ */
+export declare function typedHandler<T>(handler: (adapters: McpAdapters, input: T) => Promise<CallToolResult>): (adapters: McpAdapters, input: unknown) => Promise<CallToolResult>;
+/**
+ * Converts a ServiceResult to MCP CallToolResult format.
+ *
+ * Maps success/failure to MCP's content/isError structure.
+ * Preserves warnings and metadata in the response.
+ *
+ * @template T The type of the service result data
+ * @param result - ServiceResult from a service call
+ * @returns MCP-formatted CallToolResult
+ *
+ * @example
+ * ```typescript
+ * const serviceResult = await orgInfoService.getOrgIdentity();
+ * return serviceResultToMcp(serviceResult);
+ * ```
+ */
+export declare function serviceResultToMcp<T>(result: ServiceResult<T>): CallToolResult;
+/**
+ * Converts a ServiceResult to a paginated MCP CallToolResult.
+ *
+ * Includes `_pagination` metadata in the response envelope for
+ * cursor-based pagination through large result sets.
+ *
+ * @template T The type of the service result data
+ * @param result - ServiceResult from a service call
+ * @param pagination - Pagination metadata for the response
+ * @returns MCP-formatted CallToolResult with pagination envelope
+ */
+export declare function serviceResultToMcpPaginated<T>(result: ServiceResult<T>, pagination: PaginationMetadata): CallToolResult;
+/**
+ * Extracts a user-facing error message from a caught error and logs the
+ * full stack trace to stderr for post-mortem debugging.
+ *
+ * @param error - The caught error (may be Error or non-Error value)
+ * @param context - Tool/handler name for the log prefix
+ * @returns The error message string
+ */
+export declare function extractErrorMessage(error: unknown, context: string): string;
+/**
+ * Creates an MCP error response.
+ *
+ * @param errorCode - MCP error code
+ * @param message - Error message
+ * @returns MCP-formatted error CallToolResult
+ */
+export declare function createMcpError(errorCode: McpErrorCode, message: string): CallToolResult;