ebay-mcp 1.13.2 → 1.14.0

package/build/mcp/{ui-bridge.js → uiBridge.js}

@@ -2,23 +2,33 @@ import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { getUiCapability, registerAppResource, RESOURCE_MIME_TYPE, RESOURCE_URI_META_KEY, } from '@modelcontextprotocol/ext-apps/server';
+import { getUiRuntimeConfig } from '../config/environment.js';
 import { uiArchetypes } from '../tools/ui/archetypes.js';
 import { serverLogger } from '../utils/logger.js';
 /**
  * Decides whether interactive views should be advertised to the connected client.
  *
- * Pure and injectable (capabilities + env) so the gate is unit-testable without a
+ * Pure and injectable (capabilities + UI flag) so the gate is unit-testable without a
  * live transport. Two independent conditions must both hold: the operator has not
  * disabled UI via `EBAY_MCP_UI=off`, and the client advertised support for the MCP
  * Apps HTML profile.
+ *
+ * @param capabilities - Client capabilities received during MCP initialization.
+ * @param uiEnabledByConfig - UI kill-switch value from runtime config.
+ * @returns True when interactive UI resources should be advertised for this client.
+ *
+ * @example
+ * ```ts
+ * const enabled = resolveUiEnabled(server.server.getClientCapabilities());
+ * ```
  */
-export function resolveUiEnabled(capabilities, env = process.env) {
-    if (env.EBAY_MCP_UI === 'off') {
+export const resolveUiEnabled = (capabilities, uiEnabledByConfig = getUiRuntimeConfig().enabled) => {
+    if (!uiEnabledByConfig) {
         return false;
     }
     const capability = getUiCapability(capabilities);
     return Boolean(capability?.mimeTypes?.includes(RESOURCE_MIME_TYPE));
-}
+};
 /**
  * Builds the one-line text fallback that accompanies a rendered view.
  *
@@ -26,25 +36,41 @@ export function resolveUiEnabled(capabilities, env = process.env) {
  * plus the structured `structuredContent`. Keeping it a short summary (rather than
  * re-dumping the full JSON the view already carries) is what keeps the UI path
  * from costing more tokens than the plain path.
+ *
+ * @param view - View model produced by a tool UI mapper.
+ * @returns One-line text summary to include beside structured content.
+ *
+ * @example
+ * ```ts
+ * const text = summarizeView({ archetype: 'table', title: 'Orders', columns: [], rows: [] });
+ * ```
  */
-export function summarizeView(view) {
+export const summarizeView = (view) => {
     switch (view.archetype) {
         case 'table': {
             const count = view.rows.length;
             const tail = view.footnote ? ` — ${view.footnote}` : '';
-            return `${view.title ?? 'Results'}: ${count} ${count === 1 ? 'row' : 'rows'}${tail}. Rendered as an interactive table.`;
+            const prefix = view.title ? `${view.title}: ` : '';
+            return `${prefix}${count} ${count === 1 ? 'row' : 'rows'}${tail}. Rendered as an interactive table.`;
         }
         case 'card': {
-            const subtitle = view.subtitle ? ` — ${view.subtitle}` : '';
+            const heading = [view.title, view.subtitle].filter(Boolean).join(' — ');
+            const prefix = heading ? `${heading}: ` : '';
             const fieldCount = view.sections.reduce((total, section) => total + section.fields.length, 0);
-            return `${view.title ?? 'Details'}${subtitle}: ${fieldCount} ${fieldCount === 1 ? 'field' : 'fields'}. Rendered as an interactive detail card.`;
+            return `${prefix}${fieldCount} ${fieldCount === 1 ? 'field' : 'fields'}. Rendered as an interactive detail card.`;
         }
         case 'chart': {
             const pointCount = view.series.reduce((total, series) => total + series.points.length, 0);
-            return `${view.title ?? 'Chart'} (${view.kind}): ${view.series.length} series, ${pointCount} ${pointCount === 1 ? 'point' : 'points'}. Rendered as an interactive chart.`;
+            const prefix = view.title ? `${view.title} (${view.kind}): ` : '';
+            return `${prefix}${view.series.length} series, ${pointCount} ${pointCount === 1 ? 'point' : 'points'}. Rendered as an interactive chart.`;
+        }
+        case 'stat': {
+            const count = view.tiles.length;
+            const prefix = view.title ? `${view.title}: ` : '';
+            return `${prefix}${count} ${count === 1 ? 'metric' : 'metrics'}. Rendered as an interactive stat grid.`;
         }
     }
-}
+};
 /**
  * Adapts a {@link ViewModel} to the SDK's open-record `structuredContent` type.
  *
@@ -54,28 +80,43 @@ export function summarizeView(view) {
  * preferable to polluting every view-model interface with `[key: string]: unknown`,
  * which would silently disable excess-property checks in the tool mappers.
  */
-function asStructuredContent(view) {
-    return view;
-}
+const asStructuredContent = (view) => view;
 /**
  * Projects a tool result into its view and packages it as a UI tool result: a
  * compact summary line, the view model as `structuredContent`, and the
  * `_meta.ui.resourceUri` that tells the host which app to render.
+ *
+ * @param ui - Resolved UI binding attached to the executed tool entry.
+ * @param result - Raw tool handler result to project into a view model.
+ * @returns SDK call result carrying text, structured content, and UI metadata.
+ *
+ * @example
+ * ```ts
+ * const toolResult = buildUiToolResult(entry.ui, handlerResult);
+ * ```
  */
-export function buildUiToolResult(ui, result) {
+export const buildUiToolResult = (ui, result) => {
     const view = ui.map(result);
     return {
         content: [{ type: 'text', text: summarizeView(view) }],
         structuredContent: asStructuredContent(view),
         _meta: { ui: { resourceUri: ui.resourceUri } },
     };
-}
+};
 /**
  * Walks up from `startDir` to the nearest directory containing a `package.json`.
  * Used to locate the repo root so built views resolve identically whether the
  * server runs from `build/` (prod) or `src/` via tsx (dev).
+ *
+ * @param startDir - Directory to begin walking upward from.
+ * @returns Repo root path, or undefined when no package.json is found.
+ *
+ * @example
+ * ```ts
+ * const root = findRepoRoot(process.cwd());
+ * ```
  */
-export function findRepoRoot(startDir) {
+export const findRepoRoot = (startDir) => {
     let current = startDir;
     for (;;) {
         if (existsSync(join(current, 'package.json'))) {
@@ -83,25 +124,41 @@ export function findRepoRoot(startDir) {
         }
         const parent = dirname(current);
         if (parent === current) {
-            return undefined;
+            return;
         }
         current = parent;
     }
-}
-/** Resolves the directory that holds the built archetype HTML files (`build/ui/`). */
-export function resolveBuiltUiDir(moduleUrl) {
+};
+/**
+ * Resolves the directory that holds the built archetype HTML files (`build/ui/`).
+ *
+ * @param moduleUrl - Module URL used to anchor the repo-root search.
+ * @returns Absolute directory path for built UI assets.
+ *
+ * @example
+ * ```ts
+ * const builtUiDir = resolveBuiltUiDir(import.meta.url);
+ * ```
+ */
+export const resolveBuiltUiDir = (moduleUrl) => {
     const fromDir = dirname(fileURLToPath(moduleUrl));
     const root = findRepoRoot(fromDir);
     return root ? join(root, 'build', 'ui') : join(fromDir, '..', 'ui');
-}
+};
 /**
  * Constructs the {@link UiBridge}: reads the built archetype HTML, registers each
  * found view as a `ui://` resource, and returns the runtime-facing facade.
  *
  * @param server - The MCP server the resources and gate attach to.
  * @param moduleUrl - `import.meta.url` of the caller, used to locate `build/ui/`.
+ * @returns UI bridge facade consumed by the MCP runtime.
+ *
+ * @example
+ * ```ts
+ * const ui = createUiBridge(server, import.meta.url);
+ * ```
  */
-export function createUiBridge(server, moduleUrl) {
+export const createUiBridge = (server, moduleUrl) => {
     const builtUiDir = resolveBuiltUiDir(moduleUrl);
     const available = new Set();
     // `Object.keys` widens to `string[]`; the cast restores the manifest's key type.
@@ -148,4 +205,4 @@ export function createUiBridge(server, moduleUrl) {
             };
         },
     };
-}
+};

package/build/schemas/account-management/account.js

@@ -1,10 +1,10 @@
-import { z } from 'zod';
+import { z } from '../../utils/effectSchema.js';
 import { zodToJsonSchema } from 'zod-to-json-schema';
-import { TimeDurationUnit, RegionType, ShippingCostType, ShippingOptionType, RefundMethod, ReturnMethod, ReturnShippingCostPayer, MarketplaceId, } from '../../types/ebay-enums.js';
+import { TimeDurationUnit, RegionType, ShippingCostType, ShippingOptionType, RefundMethod, ReturnMethod, ReturnShippingCostPayer, MarketplaceId, } from '../../types/ebayEnums.js';
 /**
  * Account Management API Schemas
  *
- * This file contains Zod schemas for all Account Management endpoints.
+ * This file contains Effect-backed schemas for all Account Management endpoints.
  * Schemas are organized by endpoint and include both input and output validation.
  */
 // ============================================================================
@@ -87,6 +87,15 @@ export const createCustomPolicyInputSchema = z.object({
         label: z.string().optional(),
     }),
 });
+/** Validates the Account Management API get custom policy request payload. */
+export const getCustomPolicyInputSchema = z.object({
+    customPolicyId: z.string().describe('The custom policy ID'),
+});
+/** Validates the Account Management API update custom policy request payload. */
+export const updateCustomPolicyInputSchema = z.object({
+    customPolicyId: z.string().describe('The custom policy ID'),
+    policy: customPolicySchema.describe('Updated custom policy details'),
+});
 /**
  * Validates the Account Management API create custom policy response payload.
  */
@@ -180,6 +189,24 @@ export const getFulfillmentPoliciesOutputSchema = z.object({
 export const createFulfillmentPolicyInputSchema = z.object({
     policy: fulfillmentPolicySchema,
 });
+/** Validates the Account Management API get fulfillment policy request payload. */
+export const getFulfillmentPolicyInputSchema = z.object({
+    fulfillmentPolicyId: z.string().describe('The fulfillment policy ID'),
+});
+/** Validates the Account Management API get fulfillment policy by name request payload. */
+export const getFulfillmentPolicyByNameInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId).describe('eBay marketplace ID'),
+    name: z.string().describe('Policy name'),
+});
+/** Validates the Account Management API update fulfillment policy request payload. */
+export const updateFulfillmentPolicyInputSchema = z.object({
+    fulfillmentPolicyId: z.string().describe('The fulfillment policy ID'),
+    policy: fulfillmentPolicySchema.describe('Updated fulfillment policy details'),
+});
+/** Validates the Account Management API delete fulfillment policy request payload. */
+export const deleteFulfillmentPolicyInputSchema = z.object({
+    fulfillmentPolicyId: z.string().describe('The fulfillment policy ID'),
+});
 /**
  * Validates the Account Management API create fulfillment policy response payload.
  */
@@ -260,6 +287,24 @@ export const getPaymentPoliciesOutputSchema = z.object({
 export const createPaymentPolicyInputSchema = z.object({
     policy: paymentPolicySchema,
 });
+/** Validates the Account Management API get payment policy request payload. */
+export const getPaymentPolicyInputSchema = z.object({
+    paymentPolicyId: z.string().describe('The payment policy ID'),
+});
+/** Validates the Account Management API get payment policy by name request payload. */
+export const getPaymentPolicyByNameInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId).describe('eBay marketplace ID'),
+    name: z.string().describe('Policy name'),
+});
+/** Validates the Account Management API update payment policy request payload. */
+export const updatePaymentPolicyInputSchema = z.object({
+    paymentPolicyId: z.string().describe('The payment policy ID'),
+    policy: paymentPolicySchema.describe('Updated payment policy details'),
+});
+/** Validates the Account Management API delete payment policy request payload. */
+export const deletePaymentPolicyInputSchema = z.object({
+    paymentPolicyId: z.string().describe('The payment policy ID'),
+});
 /**
  * Validates the Account Management API create payment policy response payload.
  */
@@ -339,6 +384,24 @@ export const getReturnPoliciesOutputSchema = z.object({
 export const createReturnPolicyInputSchema = z.object({
     policy: returnPolicySchema,
 });
+/** Validates the Account Management API get return policy request payload. */
+export const getReturnPolicyInputSchema = z.object({
+    returnPolicyId: z.string().describe('The return policy ID'),
+});
+/** Validates the Account Management API get return policy by name request payload. */
+export const getReturnPolicyByNameInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId).describe('eBay marketplace ID'),
+    name: z.string().describe('Policy name'),
+});
+/** Validates the Account Management API update return policy request payload. */
+export const updateReturnPolicyInputSchema = z.object({
+    returnPolicyId: z.string().describe('The return policy ID'),
+    policy: returnPolicySchema.describe('Updated return policy details'),
+});
+/** Validates the Account Management API delete return policy request payload. */
+export const deleteReturnPolicyInputSchema = z.object({
+    returnPolicyId: z.string().describe('The return policy ID'),
+});
 /**
  * Validates the Account Management API create return policy response payload.
  */
@@ -365,6 +428,33 @@ export const salesTaxSchema = z.object({
     salesTaxPercentage: z.string().optional(),
     shippingAndHandlingTaxed: z.boolean().optional(),
 });
+/** Validates the Account Management API create or replace sales tax request payload. */
+export const createOrReplaceSalesTaxInputSchema = z.object({
+    countryCode: z.string().describe('Two-letter ISO 3166 country code'),
+    jurisdictionId: z.string().describe('Tax jurisdiction ID'),
+    salesTaxBase: salesTaxBaseSchema.describe('Sales tax details'),
+});
+/** Validates one sales tax row in a bulk create or replace request. */
+export const bulkSalesTaxRequestEntrySchema = z.object({
+    countryCode: z.string(),
+    jurisdictionId: z.string(),
+    salesTaxBase: salesTaxBaseSchema,
+});
+/** Validates the Account Management API bulk create or replace sales tax request payload. */
+export const bulkCreateOrReplaceSalesTaxInputSchema = z.object({
+    requests: z.array(bulkSalesTaxRequestEntrySchema).describe('Array of sales tax requests'),
+});
+/** Validates the Account Management API get sales tax request payload. */
+export const getSalesTaxInputSchema = z.object({
+    countryCode: z.string().describe('Two-letter ISO 3166 country code'),
+    jurisdictionId: z.string().describe('Tax jurisdiction ID'),
+});
+/** Validates the Account Management API delete sales tax request payload. */
+export const deleteSalesTaxInputSchema = getSalesTaxInputSchema;
+/** Validates the Account Management API get sales taxes request payload. */
+export const getSalesTaxesInputSchema = z.object({
+    countryCode: z.string().describe('Required: Two-letter ISO 3166-1 country code'),
+});
 /**
  * Validates the Account Management API get sales taxes response payload.
  */
@@ -381,6 +471,16 @@ export const getSalesTaxesOutputSchema = z.object({
 export const programRequestSchema = z.object({
     programType: z.string(),
 });
+/** Validates the Account Management API program opt-in request payload. */
+export const optInToProgramInputSchema = z.object({
+    request: programRequestSchema.describe('Program opt-in request'),
+});
+/** Validates the Account Management API program opt-out request payload. */
+export const optOutOfProgramInputSchema = z.object({
+    request: programRequestSchema.describe('Program opt-out request'),
+});
+/** Validates the Account Management API get opted-in programs request payload. */
+export const getOptedInProgramsInputSchema = z.object({});
 /**
  * Validates the Account Management API programs response payload.
  */
@@ -404,6 +504,32 @@ export const kycOutputSchema = z.object({
     detailedStatus: z.string().optional(),
     warnings: z.array(errorSchema).optional(),
 });
+/** Validates the Account Management API get KYC request payload. */
+export const getKycInputSchema = z.object({});
+/** Validates the Account Management API payments program request payload. */
+export const getPaymentsProgramInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId).describe('The eBay marketplace ID'),
+    paymentsProgramType: z.string().describe('The type of payments program'),
+});
+/** Validates the Account Management API payments onboarding request payload. */
+export const getPaymentsProgramOnboardingInputSchema = getPaymentsProgramInputSchema;
+/** Validates the Account Management API subscription request payload. */
+export const getSubscriptionInputSchema = z.object({
+    limit: z.string().optional().describe('Optional subscription page size limit'),
+    continuationToken: z.string().optional().describe('Optional continuation token'),
+});
+/** Validates the Account Management API get rate tables request payload. */
+export const getRateTablesInputSchema = z.object({});
+/** Validates the Account Management API advertising eligibility request payload. */
+export const getAdvertisingEligibilityInputSchema = z.object({
+    marketplaceId: z
+        .nativeEnum(MarketplaceId)
+        .describe('eBay marketplace ID to check eligibility for'),
+    programTypes: z
+        .string()
+        .optional()
+        .describe('Optional comma-separated list of program types to check eligibility for'),
+});
 // ============================================================================
 // Privileges Schemas
 // ============================================================================
@@ -421,13 +547,21 @@ export const privilegesOutputSchema = z.object({
     sellerRegistrationCompleted: z.boolean().optional(),
     warnings: z.array(errorSchema).optional(),
 });
+/** Validates the Account Management API get privileges request payload. */
+export const getPrivilegesInputSchema = z.object({});
 // ============================================================================
 // JSON Schema Conversion Functions
 // ============================================================================
 /**
- * Convert Zod schemas to JSON Schema format for MCP tools
+ * Converts Account Management API Effect-backed schemas to JSON Schema format for MCP tools.
+ *
+ * @returns Account Management API JSON schemas keyed by endpoint or shared model name.
+ * @example
+ * ```ts
+ * const schemas = getAccountManagementJsonSchemas();
+ * ```
  */
-export function getAccountManagementJsonSchemas() {
+export const getAccountManagementJsonSchemas = () => {
     return {
         // Custom Policies
         getCustomPoliciesInput: zodToJsonSchema(getCustomPoliciesInputSchema, 'getCustomPoliciesInput'),
@@ -457,9 +591,13 @@ export function getAccountManagementJsonSchemas() {
         salesTaxDetails: zodToJsonSchema(salesTaxSchema, 'salesTaxDetails'),
         // Programs
         programRequest: zodToJsonSchema(programRequestSchema, 'programRequest'),
+        getOptedInProgramsInput: zodToJsonSchema(getOptedInProgramsInputSchema, 'getOptedInProgramsInput'),
         programsOutput: zodToJsonSchema(programsOutputSchema, 'programsOutput'),
         // KYC & Privileges
+        getKycInput: zodToJsonSchema(getKycInputSchema, 'getKycInput'),
         kycOutput: zodToJsonSchema(kycOutputSchema, 'kycOutput'),
+        getRateTablesInput: zodToJsonSchema(getRateTablesInputSchema, 'getRateTablesInput'),
+        getPrivilegesInput: zodToJsonSchema(getPrivilegesInputSchema, 'getPrivilegesInput'),
         privilegesOutput: zodToJsonSchema(privilegesOutputSchema, 'privilegesOutput'),
     };
-}
+};

package/build/schemas/analytics/analytics.js

@@ -1,9 +1,9 @@
-import { z } from 'zod';
+import { z } from '../../utils/effectSchema.js';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 /**
  * Analytics API Schemas
  *
- * This file contains Zod schemas for the Sell Analytics API.
+ * This file contains Effect-backed schemas for the Sell Analytics API.
  * Schemas are organized by type and include all analytics-related endpoints.
  */
 // ============================================================================
@@ -133,33 +133,47 @@ const reportSchema = z.object({
 // ============================================================================
 // Input Schemas for Operations
 // ============================================================================
-const getCustomerServiceMetricInputSchema = z.object({
-    customer_service_metric_type: z.string(),
-    evaluation_type: z.string(),
-    evaluation_marketplace_id: z.string(),
-});
-const getSellerStandardsProfileInputSchema = z.object({
-    program: z.string(),
-    cycle: z.string(),
-});
-const getTrafficReportInputSchema = z.object({
-    dimension: z.string().optional(),
-    filter: z.string().optional(),
-    metric: z.string().optional(),
-    sort: z.string().optional(),
+/** Input accepted by Analytics API findSellerStandardsProfiles. */
+export const findSellerStandardsProfilesInputSchema = z.object({});
+/** Input accepted by Analytics API getCustomerServiceMetric. */
+export const getCustomerServiceMetricInputSchema = z.object({
+    customerServiceMetricType: z
+        .string()
+        .describe('Customer service metric type, e.g., ITEM_NOT_AS_DESCRIBED'),
+    evaluationType: z.string().describe('Evaluation type, e.g., CURRENT or PROJECTED'),
+    evaluationMarketplaceId: z.string().describe('Marketplace ID used for the evaluation'),
+});
+/** Input accepted by Analytics API getSellerStandardsProfile. */
+export const getSellerStandardsProfileInputSchema = z.object({
+    program: z.string().describe('Seller standards program identifier'),
+    cycle: z.string().describe('Seller standards cycle, e.g., CURRENT or PROJECTED'),
+});
+/** Input accepted by Analytics API getTrafficReport. */
+export const getTrafficReportInputSchema = z.object({
+    dimension: z.string().describe('Report dimension, e.g., LISTING or DAY'),
+    filter: z.string().describe('eBay traffic report filter expression'),
+    metric: z.string().describe('Comma-delimited report metrics to retrieve'),
+    sort: z.string().optional().describe('Optional metric sort expression'),
 });
 // ============================================================================
 // JSON Schema Conversion Functions
 // ============================================================================
 /**
- * Convert Zod schemas to JSON Schema format for MCP tools
+ * Converts Analytics API Effect-backed schemas to JSON Schema format for MCP tools.
+ *
+ * @returns Analytics API JSON schemas keyed by endpoint or shared model name.
+ * @example
+ * ```ts
+ * const schemas = getAnalyticsJsonSchemas();
+ * ```
  */
-export function getAnalyticsJsonSchemas() {
+export const getAnalyticsJsonSchemas = () => {
     return {
         // Customer Service Metrics
         getCustomerServiceMetricInput: zodToJsonSchema(getCustomerServiceMetricInputSchema, 'getCustomerServiceMetricInput'),
         getCustomerServiceMetricOutput: zodToJsonSchema(getCustomerServiceMetricResponseSchema, 'getCustomerServiceMetricOutput'),
         // Seller Standards Profiles
+        findSellerStandardsProfilesInput: zodToJsonSchema(findSellerStandardsProfilesInputSchema, 'findSellerStandardsProfilesInput'),
         findSellerStandardsProfilesOutput: zodToJsonSchema(findSellerStandardsProfilesResponseSchema, 'findSellerStandardsProfilesOutput'),
         getSellerStandardsProfileInput: zodToJsonSchema(getSellerStandardsProfileInputSchema, 'getSellerStandardsProfileInput'),
         getSellerStandardsProfileOutput: zodToJsonSchema(standardsProfileSchema, 'getSellerStandardsProfileOutput'),
@@ -188,4 +202,4 @@ export function getAnalyticsJsonSchemas() {
         standardsProfile: zodToJsonSchema(standardsProfileSchema, 'standardsProfile'),
         value: zodToJsonSchema(valueSchema, 'value'),
     };
-}
+};

package/build/schemas/communication/messages.js

@@ -1,10 +1,10 @@
-import { z } from 'zod';
+import { z } from '../../utils/effectSchema.js';
 import { zodToJsonSchema } from 'zod-to-json-schema';
-import { MessageReferenceType, FeedbackRating } from '../../types/ebay-enums.js';
+import { MessageReferenceType, FeedbackRating } from '../../types/ebayEnums.js';
 /**
  * Communication API Schemas - Messages, Feedback, and Notifications
  *
- * This file contains Zod schemas for all Communication endpoints including:
+ * This file contains Effect-backed schemas for all Communication endpoints including:
  * - Message API
  * - Feedback API
  * - Notification API
@@ -351,47 +351,19 @@ export const sendOfferToInterestedBuyersOutputSchema = z.object({
     offerToInterestedBuyersId: z.string().optional(),
     warnings: z.array(errorSchema).optional(),
 });
-/**
- * Validates the Communication API get offers to buyers request payload.
- */
-export const getOffersToBuyersInputSchema = z.object({
-    filter: z.string().optional().describe('Filter criteria'),
-    limit: z.number().optional().describe('Number of offers to return'),
-    offset: z.number().optional().describe('Number of offers to skip'),
-});
-/**
- * Validates the Communication API get offers to buyers response payload.
- */
-export const getOffersToBuyersOutputSchema = z.object({
-    offers: z
-        .array(z.object({
-        offerToInterestedBuyersId: z.string().optional(),
-        offeredItems: z
-            .array(z.object({
-            offerId: z.string().optional(),
-            price: amountSchema.optional(),
-            quantity: z.number().optional(),
-        }))
-            .optional(),
-        creationDate: z.string().optional(),
-        status: z.string().optional(),
-    }))
-        .optional(),
-    href: z.string().optional(),
-    limit: z.number().optional(),
-    next: z.string().optional(),
-    offset: z.number().optional(),
-    prev: z.string().optional(),
-    total: z.number().optional(),
-    warnings: z.array(errorSchema).optional(),
-});
 // ============================================================================
 // JSON Schema Conversion Functions
 // ============================================================================
 /**
- * Convert Zod schemas to JSON Schema format for MCP tools
+ * Converts Communication API Effect-backed schemas to JSON Schema format for MCP tools.
+ *
+ * @returns Communication API JSON schemas keyed by endpoint or shared model name.
+ * @example
+ * ```ts
+ * const schemas = getCommunicationJsonSchemas();
+ * ```
  */
-export function getCommunicationJsonSchemas() {
+export const getCommunicationJsonSchemas = () => {
     return {
         // Message API
         sendMessageInput: zodToJsonSchema(sendMessageInputSchema, 'sendMessageInput'),
@@ -423,7 +395,5 @@ export function getCommunicationJsonSchemas() {
         // Negotiation API
         sendOfferToInterestedBuyersInput: zodToJsonSchema(sendOfferToInterestedBuyersInputSchema, 'sendOfferToInterestedBuyersInput'),
         sendOfferToInterestedBuyersOutput: zodToJsonSchema(sendOfferToInterestedBuyersOutputSchema, 'sendOfferToInterestedBuyersOutput'),
-        getOffersToBuyersInput: zodToJsonSchema(getOffersToBuyersInputSchema, 'getOffersToBuyersInput'),
-        getOffersToBuyersOutput: zodToJsonSchema(getOffersToBuyersOutputSchema, 'getOffersToBuyersOutput'),
     };
-}
+};