ebay-mcp 1.18.0 → 1.18.2

package/build/scripts/skills.js

@@ -1,15 +1,14 @@
 #!/usr/bin/env node
-import { resolve } from 'path';
-import { fileURLToPath } from 'url';
 import prompts from 'prompts';
 import { ALL_PROVIDERS, applyWrite, buildRegistrySnapshot, detectProvider, planWrite, providerLabel, renderSkillTargets, } from '../skills/index.js';
 import { ebayPalette, printHeading, printInfo, printRule, printSuccess, printWarning, ui, } from '../utils/cliUi.js';
 import { getErrorMessage } from '../utils/errors.js';
 import { Effect, Either } from 'effect';
 import process from 'node:process';
+import { isEntryModule } from '../utils/entryModule.js';
 const ALL_LAYERS = ['using', 'contributing'];
 /** Splits a comma list flag value into trimmed, non-empty tokens. */
-const parseList = (value) => (value ?? '')
+const parseList = (rawList) => (rawList ?? '')
     .split(',')
     .map((token) => token.trim())
     .filter(Boolean);
@@ -25,8 +24,8 @@ const readFlagValue = (argv, flag) => {
 /** Parses skills CLI flags, ignoring the leading `skills` subcommand token. */
 const parseFlags = (argv) => {
     const args = argv.filter((arg) => arg !== 'skills');
-    const providers = parseList(readFlagValue(args, '--providers')).filter((value) => ALL_PROVIDERS.includes(value));
-    const layers = parseList(readFlagValue(args, '--layer') ?? readFlagValue(args, '--layers')).filter((value) => ALL_LAYERS.includes(value));
+    const providers = parseList(readFlagValue(args, '--providers')).filter((token) => ALL_PROVIDERS.includes(token));
+    const layers = parseList(readFlagValue(args, '--layer') ?? readFlagValue(args, '--layers')).filter((token) => ALL_LAYERS.includes(token));
     return {
         help: args.includes('--help') || args.includes('-h'),
         yes: args.includes('--yes') || args.includes('-y'),
@@ -188,7 +187,7 @@ export const runSkillsWizard = async (options = {}) => {
         }
     }
     const rendered = renderSkillTargets({ providers, layers, scope, cwd, home, snapshot });
-    const plans = rendered.map((item) => planWrite(item.target, item.payload));
+    const plans = rendered.map((renderedTarget) => planWrite(renderedTarget.target, renderedTarget.payload));
     printPreview(plans);
     if (flags.dryRun) {
         printInfo('Dry run — no files written.');
@@ -220,26 +219,24 @@ export const runSkillsWizard = async (options = {}) => {
     // targets sharing one file (both Codex layers → one AGENTS.md) compose instead
     // of the second clobbering the first.
     let written = 0;
-    for (const item of rendered) {
-        const plan = planWrite(item.target, item.payload);
-        const result = applyWrite(plan, { dryRun: false, force: flags.force });
-        if (result.written) {
+    for (const renderedTarget of rendered) {
+        const plan = planWrite(renderedTarget.target, renderedTarget.payload);
+        const applied = applyWrite(plan, { dryRun: false, force: flags.force });
+        if (applied.written) {
             written += 1;
-            printSuccess(`${result.action} ${plan.target.path}`);
+            printSuccess(`${applied.action} ${plan.target.path}`);
         }
     }
     printHeading('Done');
     printInfo(`${written} file(s) written. Restart your AI tool so it picks up the new skills.`);
 };
-const entryPath = process.argv[1] ? resolve(process.argv[1]) : undefined;
-const modulePath = resolve(fileURLToPath(import.meta.url));
-if (entryPath && modulePath === entryPath) {
+if (isEntryModule(import.meta.url)) {
     void Effect.runPromise(Effect.either(Effect.tryPromise({
         try: () => runSkillsWizard(),
         catch: (error) => error,
-    }))).then((result) => {
-        if (Either.isLeft(result)) {
-            console.error(ui.error('\n  Skills install failed:'), getErrorMessage(result.left));
+    }))).then((skillsOutcome) => {
+        if (Either.isLeft(skillsOutcome)) {
+            console.error(ui.error('\n  Skills install failed:'), getErrorMessage(skillsOutcome.left));
             process.exitCode = 1;
         }
     });

package/build/scripts/specRefs.js

@@ -48,7 +48,7 @@ export const replaceDanglingSchemaRefs = (spec) => {
                 return { description: `Undefined upstream schema ${name}` };
             }
         }
-        return Object.fromEntries(Object.entries(node).map(([key, value]) => [key, rewrite(value)]));
+        return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, rewrite(child)]));
     };
     const rewritten = rewrite(spec);
     return { spec: dangling.size > 0 ? rewritten : spec, danglingRefs: [...dangling] };

package/build/scripts/specSources.js

@@ -0,0 +1,144 @@
+/**
+ * Official eBay OpenAPI specs that `pnpm sync` downloads into the local spec cache.
+ *
+ * Each spec lands in `.cache/ebay-specs/<folder>/`, and its generated types land in
+ * `src/types/<folder>/`, so `folder` must match the existing generated-type layout.
+ */
+/** Every spec `pnpm sync` downloads, grouped the same way as `src/types/`. */
+export const specSources = [
+    {
+        api: 'Developer Analytics API',
+        folder: 'application-settings',
+        url: 'https://developer.ebay.com/api-docs/master/developer/analytics/openapi/3/developer_analytics_v1_beta_oas3.json',
+    },
+    {
+        api: 'Key Management API',
+        folder: 'application-settings',
+        url: 'https://developer.ebay.com/api-docs/master/developer/key-management/openapi/3/developer_key_management_v1_oas3.json',
+    },
+    {
+        api: 'Client Registration API',
+        folder: 'application-settings',
+        url: 'https://developer.ebay.com/api-docs/master/developer/client-registration/openapi/3/developer_client_registration_v1_oas3.json',
+    },
+    {
+        api: 'Inventory API',
+        folder: 'sell-apps/listing-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/inventory/openapi/3/sell_inventory_v1_oas3.json',
+    },
+    {
+        api: 'Feed API',
+        folder: 'sell-apps/listing-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/feed/openapi/3/sell_feed_v1_oas3.json',
+    },
+    {
+        api: 'Media API',
+        folder: 'sell-apps/listing-management',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/media/openapi/3/commerce_media_v1_beta_oas3.json',
+    },
+    {
+        api: 'Stores API',
+        folder: 'sell-apps/listing-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/stores/openapi/3/sell_stores_v1_oas3.json',
+    },
+    {
+        api: 'Metadata API',
+        folder: 'sell-apps/listing-metadata',
+        url: 'https://developer.ebay.com/api-docs/master/sell/metadata/openapi/3/sell_metadata_v1_oas3.json',
+    },
+    {
+        api: 'Taxonomy API',
+        folder: 'sell-apps/listing-metadata',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/taxonomy/openapi/3/commerce_taxonomy_v1_oas3.json',
+    },
+    {
+        api: 'Charity API',
+        folder: 'sell-apps/listing-metadata',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/charity/openapi/3/commerce_charity_v1_oas3.json',
+    },
+    {
+        api: 'Account API (v1)',
+        folder: 'sell-apps/account-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/account/openapi/3/sell_account_v1_oas3.json',
+    },
+    {
+        api: 'Account API (v2)',
+        folder: 'sell-apps/account-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/account/v2/openapi/3/sell_account_v2_oas3.json',
+    },
+    {
+        api: 'Finances API',
+        folder: 'sell-apps/account-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/finances/openapi/3/sell_finances_v1_oas3.json',
+    },
+    {
+        api: 'Message API',
+        folder: 'sell-apps/communication',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/message/openapi/3/commerce_message_v1_oas3.json',
+    },
+    {
+        api: 'Notification API',
+        folder: 'sell-apps/communication',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/notification/openapi/3/commerce_notification_v1_oas3.json',
+    },
+    {
+        api: 'Negotiation API',
+        folder: 'sell-apps/communication',
+        url: 'https://developer.ebay.com/api-docs/master/sell/negotiation/openapi/3/sell_negotiation_v1_oas3.json',
+    },
+    {
+        api: 'Feedback API',
+        folder: 'sell-apps/communication',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/feedback/openapi/3/commerce_feedback_v1_beta_oas3.json',
+    },
+    {
+        api: 'Fulfillment API',
+        folder: 'sell-apps/order-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/fulfillment/openapi/3/sell_fulfillment_v1_oas3.json',
+    },
+    {
+        api: 'Logistics API',
+        folder: 'sell-apps/order-management',
+        url: 'https://developer.ebay.com/api-docs/master/sell/logistics/openapi/3/sell_logistics_v1_oas3.json',
+    },
+    {
+        api: 'Marketing API',
+        folder: 'sell-apps/marketing-and-promotions',
+        url: 'https://developer.ebay.com/api-docs/master/sell/marketing/openapi/3/sell_marketing_v1_oas3.json',
+    },
+    {
+        api: 'Recommendation API',
+        folder: 'sell-apps/marketing-and-promotions',
+        url: 'https://developer.ebay.com/api-docs/master/sell/recommendation/openapi/3/sell_recommendation_v1_oas3.json',
+    },
+    {
+        api: 'Analytics API',
+        folder: 'sell-apps/analytics-and-report',
+        url: 'https://developer.ebay.com/api-docs/master/sell/analytics/openapi/3/sell_analytics_v1_oas3.json',
+    },
+    {
+        api: 'Translation API',
+        folder: 'sell-apps/other-apis',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/translation/openapi/3/commerce_translation_v1_beta_oas3.json',
+    },
+    {
+        api: 'Compliance API',
+        folder: 'sell-apps/other-apis',
+        url: 'https://developer.ebay.com/api-docs/master/sell/compliance/openapi/3/sell_compliance_v1_oas3.json',
+    },
+    {
+        api: 'Identity API',
+        folder: 'sell-apps/other-apis',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/identity/openapi/3/commerce_identity_v1_oas3.json',
+    },
+    {
+        api: 'eDelivery International Shipping API',
+        folder: 'sell-apps/other-apis',
+        url: 'https://developer.ebay.com/api-docs/master/sell/edelivery_international_shipping/openapi/3/sell_edelivery_international_shipping_oas3.json',
+    },
+    {
+        api: 'Vero API',
+        folder: 'sell-apps/other-apis',
+        url: 'https://developer.ebay.com/api-docs/master/commerce/vero/openapi/3/commerce_vero_v1_oas3.json',
+    },
+];

package/build/serverHttp.js

@@ -1,19 +1,18 @@
 /**
  * eBay API MCP Server with HTTP Transport and OAuth 2.1 Authorization.
  */
-import { resolve } from 'path';
-import { fileURLToPath } from 'url';
 import { validateEnvironmentConfig } from './config/environment.js';
 import { createHttpMcpApp, createHttpTransportConfigFromEnv, getHttpServerUrl, } from './mcp/httpTransport.js';
 import { getErrorMessage } from './utils/errors.js';
 import { serverLogger } from './utils/logger.js';
 import { Effect, Either } from 'effect';
 import process from 'node:process';
+import { isEntryModule } from './utils/entryModule.js';
 const CONFIG = createHttpTransportConfigFromEnv(process.env);
 function logEnvironmentValidation() {
     const validation = validateEnvironmentConfig();
-    validation.infos.forEach((info) => {
-        serverLogger.info(info);
+    validation.infos.forEach((notice) => {
+        serverLogger.info(notice);
     });
     if (validation.warnings.length > 0) {
         serverLogger.warn('Environment Configuration Warnings:');
@@ -83,8 +82,6 @@ async function main() {
         process.exit(1);
     }
 }
-const entryPath = process.argv[1] ? resolve(process.argv[1]) : undefined;
-const modulePath = resolve(fileURLToPath(import.meta.url));
-if (entryPath && modulePath === entryPath) {
+if (isEntryModule(import.meta.url)) {
     await main();
 }

package/build/skills/content.js

@@ -87,8 +87,8 @@ export const buildUsingDoc = (snapshot) => ({
 });
 /**
  * Builds the "contributing" skill: how an AI working on the ebay-mcp repo should
- * operate. Mirrors AGENTS.md (validation commands, module map, the add-a-tool
- * flow, conventions) against the real `src/tools/categories/` layout.
+ * operate: validation commands, module map, the add-a-tool flow, and
+ * conventions, against the real `src/tools/categories/` layout.
  *
  * @param snapshot Live tool count and family index.
  * @returns The provider-neutral skill document.
@@ -101,16 +101,16 @@ export const buildUsingDoc = (snapshot) => ({
 export const buildContributingDoc = (snapshot) => ({
     slug: 'ebay-mcp-contributing',
     title: 'Contributing to ebay-mcp',
-    description: `Work on the ebay-mcp server itself: ${snapshot.toolCount} tools across eBay's Sell APIs (TypeScript/ESM, Effect-backed validation, OpenAPI-generated types). Use when adding or changing eBay tools/endpoints, wiring the registry, or running the project's checks.`,
-    intro: `A local MCP server exposing **${snapshot.toolCount} tools across 100% of eBay's Sell APIs** — TypeScript/Node.js (ESM), \`@modelcontextprotocol/sdk\`, Effect-backed validation, OpenAPI-generated types. Entry points: \`src/index.ts\` (STDIO) and \`src/serverHttp.ts\` (HTTP).`,
+    description: `Work on the ebay-mcp server itself: ${snapshot.toolCount} tools across eBay's Sell APIs (TypeScript/ESM, Zod tool-input schemas, OpenAPI-generated types). Use when adding or changing eBay tools/endpoints, wiring the registry, or running the project's checks.`,
+    intro: `A local MCP server exposing **${snapshot.toolCount} tools across 100% of eBay's Sell APIs** — TypeScript/Node.js (ESM), \`@modelcontextprotocol/sdk\`, Zod tool-input schemas, Effect for typed async errors, OpenAPI-generated types. Entry points: \`src/index.ts\` (STDIO) and \`src/serverHttp.ts\` (HTTP).`,
     sections: [
         {
             heading: 'Validation (run before a PR)',
             body: [
                 '```bash',
-                'npm run check     # tsc --noEmit + eslint + prettier --check  (must pass)',
-                'npm test          # vitest run',
-                'npm run build     # tsc + tsc-alias → build/',
+                'pnpm check        # tsc --noEmit (src + mcp-apps) + biome check  (must pass)',
+                'pnpm test         # vitest run',
+                'pnpm build        # tsc + tsc-alias + MCP Apps views → build/',
                 '```',
             ].join('\n'),
         },
@@ -120,12 +120,12 @@ export const buildContributingDoc = (snapshot) => ({
                 '| Path | Owns |',
                 '| --- | --- |',
                 '| `index.ts` / `serverHttp.ts` | MCP entry points (STDIO / HTTP) |',
-                '| `api/` | eBay API client implementations (one area per file) |',
+                '| `api/` | eBay API modules (one area per folder), `client/` (REST and Trading XML clients), and the `ebaySellerApi.ts` facade |',
                 '| `auth/` | OAuth 2.0 flow and token management |',
                 '| `config/` | Environment loading, constants, marketplace defaults |',
                 '| `tools/` | Tool wiring — `registry.ts`, `contracts.ts`, `defineTool.ts`, and `categories/` (13 family files that co-locate each tool definition with its handler via `defineTool`) |',
                 "| `skills/` | Agent-skills generator (this skill's source) |",
-                '| `schemas/` | Shared Effect-backed schemas |',
+                '| `schemas/` | Shared Zod schemas per API family |',
                 "| `types/` | TypeScript types — **auto-generated** from OpenAPI specs (don't hand-edit) |",
                 '| `scripts/` | CLI tooling: `setup.ts`, `skills.ts`, `devSync.ts`, `diagnostics.ts` |',
                 '| `utils/` | Shared utilities (logging, http, errors) |',
@@ -134,19 +134,19 @@ export const buildContributingDoc = (snapshot) => ({
         {
             heading: 'Add a tool or endpoint',
             body: [
-                '1. `npm run sync` — download the latest eBay specs, regenerate types, report missing endpoints.',
+                '1. `pnpm sync` — download the latest eBay specs, regenerate types, report missing endpoints.',
                 '2. Add the API method in `src/api/`.',
                 '3. Add a `defineTool({ ... handler })` entry in the matching `src/tools/categories/<family>.ts` — definition and handler live together; `registry.ts` derives everything from `categories/index.ts`.',
                 '4. Add tests in `tests/`.',
-                '5. `npm run check && npm test`.',
+                '5. `pnpm check && pnpm test`.',
             ].join('\n'),
         },
         {
             heading: 'Conventions',
             body: [
                 '- **No `any`** — specific types; prefer narrowing over assertions. `types/` is generated, so model new shapes from the specs.',
-                '- Validate tool inputs with Effect-backed schemas from `@/utils/effectSchema.js`; derive related schemas rather than duplicating fields.',
-                '- Commit with Conventional Commits (releases are changeset-driven).',
+                "- Validate tool inputs with Zod schemas (`import { z } from 'zod'`); derive related schemas rather than duplicating fields.",
+                '- Commit with Conventional Commits; merged PR labels (`major`/`minor`, else patch) pick the release bump.',
                 '- Logs go to **stderr** only — stdout is reserved for the MCP protocol.',
             ].join('\n'),
         },

package/build/skills/install.js

@@ -30,20 +30,20 @@ const mergeManagedBlock = (existing, layer, inner) => {
  *   always preserved (never `skip-foreign`).
  *
  * @param target Resolved destination.
- * @param payload Rendered content — a full file for owned targets, inner block
+ * @param renderedContent Rendered content — a full file for owned targets, inner block
  *   content for managed targets.
  * @returns The planned action and the exact bytes that would be written.
  *
  * @example
  * ```ts
- * const plan = planWrite(target, payload);
+ * const plan = planWrite(target, renderedContent);
  * ```
  */
-export const planWrite = (target, payload) => {
+export const planWrite = (target, renderedContent) => {
     const exists = existsSync(target.path);
     const previousContents = exists ? readFileSync(target.path, 'utf-8') : undefined;
     if (target.kind === 'managed-block') {
-        const nextContents = mergeManagedBlock(previousContents ?? '', target.layer, payload);
+        const nextContents = mergeManagedBlock(previousContents ?? '', target.layer, renderedContent);
         let action = 'create';
         if (exists) {
             action = nextContents === previousContents ? 'unchanged' : 'update';
@@ -52,13 +52,13 @@ export const planWrite = (target, payload) => {
     }
     // owned-file
     if (!exists) {
-        return { target, action: 'create', nextContents: payload };
+        return { target, action: 'create', nextContents: renderedContent };
     }
     if (!isOwnedByUs(previousContents ?? '', target.layer)) {
-        return { target, action: 'skip-foreign', nextContents: payload, previousContents };
+        return { target, action: 'skip-foreign', nextContents: renderedContent, previousContents };
     }
-    const action = previousContents === payload ? 'unchanged' : 'update';
-    return { target, action, nextContents: payload, previousContents };
+    const action = previousContents === renderedContent ? 'unchanged' : 'update';
+    return { target, action, nextContents: renderedContent, previousContents };
 };
 /**
  * Applies a write plan. Skips no-op writes (`unchanged`) and refuses to clobber
@@ -71,7 +71,7 @@ export const planWrite = (target, payload) => {
  *
  * @example
  * ```ts
- * const result = applyWrite(plan, { dryRun: true });
+ * const writeOutcome = applyWrite(plan, { dryRun: true });
  * ```
  */
 export const applyWrite = (plan, options = {}) => {

package/build/skills/render.js

@@ -14,7 +14,7 @@ const renderBody = (doc, baseLevel) => {
     return parts.join('\n');
 };
 /** YAML frontmatter scalar that is safe for arbitrary text (JSON strings are valid YAML). */
-const yamlString = (value) => JSON.stringify(value);
+const yamlString = (text) => JSON.stringify(text);
 /**
  * Renders a Claude Code skill file (`SKILL.md`): YAML frontmatter (`name`,
  * `description`) so the model can invoke it on demand, an ownership marker, then
@@ -87,7 +87,7 @@ export const renderCodexSection = (doc) => renderBody(doc, 2);
  *
  * @example
  * ```ts
- * const payload = renderSkill('codex', doc, 'using');
+ * const skillContent = renderSkill('codex', doc, 'using');
  * ```
  */
 export const renderSkill = (provider, doc, layer) => {

package/build/tools/categories/communication.js

@@ -7,7 +7,7 @@ import { createDestinationSchema, createSubscriptionFilterSchema, createSubscrip
 /**
  * Communication API tools for member messages, notifications, and seller feedback.
  *
- * Each tool derives its transport schema from the same Effect-backed object whose inferred
+ * Each tool derives its transport schema from the same Zod object whose inferred
  * args are passed directly to the endpoint method. Handlers stay at the MCP
  * boundary: they run one endpoint Effect and avoid response or input reshaping.
  */

package/build/tools/categories/connector.js

@@ -1,4 +1,4 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 import { Effect } from 'effect';
 import { defineTool } from '../../tools/defineTool.js';
 const connectorSearchInputSchema = z.object({
@@ -46,19 +46,22 @@ export const connectorEntries = [
             const matches = [];
             let offset = 0;
             while (matches.length < limit) {
-                const response = yield* api.inventory.getInventoryItems({ limit: pageSize, offset });
-                const pageItems = response.inventoryItems ?? [];
+                const inventoryPage = yield* api.inventory.getInventoryItems({
+                    limit: pageSize,
+                    offset,
+                });
+                const pageItems = inventoryPage.inventoryItems ?? [];
                 if (pageItems.length === 0) {
                     break;
                 }
                 // Only items with valid SKUs can be passed to getInventoryItem later.
-                const itemsWithSku = pageItems.filter((item) => typeof item.sku === 'string' && item.sku.trim() !== '');
+                const itemsWithSku = pageItems.filter((inventoryItem) => typeof inventoryItem.sku === 'string' && inventoryItem.sku.trim() !== '');
                 const filtered = query
-                    ? itemsWithSku.filter((item) => (item.product?.title ?? '').toLowerCase().includes(query))
+                    ? itemsWithSku.filter((inventoryItem) => (inventoryItem.product?.title ?? '').toLowerCase().includes(query))
                     : itemsWithSku;
                 matches.push(...filtered);
                 offset += pageSize;
-                const total = response.total;
+                const total = inventoryPage.total;
                 if (typeof total === 'number' && offset >= total) {
                     break;
                 }
@@ -66,9 +69,9 @@ export const connectorEntries = [
                     break;
                 }
             }
-            const results = matches.slice(0, limit).map((item) => ({
-                id: item.sku,
-                title: item.product?.title ?? '',
+            const results = matches.slice(0, limit).map((match) => ({
+                id: match.sku,
+                title: match.product?.title ?? '',
                 url: 'https://www.ebay.com/', // Placeholder: eBay does not expose a canonical item URL here.
             }));
             // The ChatGPT connector spec requires a single text content block.
@@ -104,23 +107,23 @@ export const connectorEntries = [
         },
         handler: (api, args) => Effect.runPromise(Effect.gen(function* () {
             const sku = args.id;
-            const item = yield* api.inventory.getInventoryItem({ sku });
-            const result = {
+            const inventoryItem = yield* api.inventory.getInventoryItem({ sku });
+            const connectorDocument = {
                 id: sku,
-                title: item.product?.title ?? '',
-                text: item.product?.description ?? '',
+                title: inventoryItem.product?.title ?? '',
+                text: inventoryItem.product?.description ?? '',
                 url: 'https://www.ebay.com/', // Placeholder: eBay does not expose a canonical item URL here.
                 metadata: {
                     source: 'ebay_inventory',
-                    aspects: item.product?.aspects,
-                    condition: item.condition,
+                    aspects: inventoryItem.product?.aspects,
+                    condition: inventoryItem.condition,
                 },
             };
             return {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify(result),
+                        text: JSON.stringify(connectorDocument),
                     },
                 ],
             };

package/build/tools/categories/fulfillment.js

@@ -81,8 +81,8 @@ export const fulfillmentEntries = [
             filter: args.filter,
             limit: args.maxResults ?? DEFAULT_ORDER_SCAN_LIMIT,
         })
-            .pipe(Effect.map((result) => {
-            const orders = result.orders ?? [];
+            .pipe(Effect.map((orderPage) => {
+            const orders = orderPage.orders ?? [];
             const matches = filterOrdersWithCancellationRequests(orders);
             return {
                 totalScanned: orders.length,
@@ -101,8 +101,8 @@ export const fulfillmentEntries = [
             filter: args.filter,
             limit: args.maxResults ?? DEFAULT_ORDER_SCAN_LIMIT,
         })
-            .pipe(Effect.map((result) => {
-            const orders = result.orders ?? [];
+            .pipe(Effect.map((orderPage) => {
+            const orders = orderPage.orders ?? [];
             const matches = filterRefundedOrders(orders);
             return {
                 totalScanned: orders.length,

package/build/tools/categories/inventory.js

@@ -1,5 +1,5 @@
 import { Effect } from 'effect';
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { defineTool } from '../../tools/defineTool.js';
 import { mapInventoryItemsToTable, mapInventoryItemToCard, mapLocationsToTable, mapOffersToTable, mapOfferToCard, } from '../../tools/ui/maps.js';

package/build/tools/categories/metadata.js

@@ -1,4 +1,4 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 import { MarketplaceId } from '../../types/ebayEnums.js';
 import { shippingMetadataInputSchema } from '../../schemas/metadata/shipping.js';
 import { defineTool } from '../../tools/defineTool.js';

package/build/tools/categories/taxonomy.js

@@ -1,4 +1,4 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 import { categoryTreeIdInputSchema } from '../../schemas/taxonomy/categoryTree.js';
 import { defineTool } from '../../tools/defineTool.js';
 import { formatFileResult } from '../../tools/fileResult.js';

package/build/tools/categories/tokenManagement.js

@@ -1,4 +1,4 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 import { buildCredentialDisplay, maskToken } from '../../auth/credentialSession.js';
 import { getOAuthAuthorizationUrl, validateScopes } from '../../config/environment.js';
 import { defineTool } from '../../tools/defineTool.js';
@@ -14,11 +14,11 @@ const tokenToolError = (operation, message, error) => new TokenManagementToolErr
     ...(error === undefined ? {} : { cause: error }),
 });
 /** Convert an optional token expiry value into a timestamp inside the token tool Effect. */
-const optionalTokenExpiryTimestamp = (value, operation, message) => {
-    if (value === undefined) {
+const optionalTokenExpiryTimestamp = (expiry, operation, message) => {
+    if (expiry === undefined) {
         return Effect.succeed(undefined);
     }
-    return convertToTimestamp(value).pipe(Effect.mapError((error) => tokenToolError(operation, message, error)));
+    return convertToTimestamp(expiry).pipe(Effect.mapError((error) => tokenToolError(operation, message, error)));
 };
 const missingClientIdError = tokenToolError('getOAuthUrl', 'EBAY_CLIENT_ID environment variable is required to generate OAuth URL');
 const missingRedirectUriError = tokenToolError('getOAuthUrl', 'Redirect URI is required. Either provide it as a parameter or set EBAY_REDIRECT_URI in your .env file.');
@@ -121,7 +121,7 @@ export const tokenManagementEntries = [
                 ? validateScopes(scopes, config.environment)
                 : { warnings: [], validScopes: scopes };
             const authUrl = getOAuthAuthorizationUrl(config.clientId, redirectUri, config.environment, scopeValidation.validScopes, args.state);
-            const result = {
+            const authorizationDetails = {
                 authorizationUrl: authUrl,
                 redirectUri,
                 instructions: 'Open this URL in a browser to authorize the application. After authorization, you will be redirected to your redirect URI with an authorization code that can be exchanged for an access token.',
@@ -129,9 +129,9 @@ export const tokenManagementEntries = [
                 scopes: scopes ?? 'default (all Sell API scopes)',
             };
             if (scopeValidation.warnings.length > 0) {
-                result.warnings = scopeValidation.warnings;
+                authorizationDetails.warnings = scopeValidation.warnings;
             }
-            return result;
+            return authorizationDetails;
         })),
     }),
     defineTool({
@@ -324,7 +324,7 @@ export const tokenManagementEntries = [
             'COMMON ERRORS:\n' +
             '- "invalid or was issued to another client": Code expired, get fresh code\n' +
             '- "Insufficient permissions": Re-run OAuth flow with additional scopes in ebay_get_oauth_url\n\n' +
-            'For complete OAuth guide with scopes, troubleshooting, and examples, see: docs/auth/OAUTH_QUICK_REFERENCE.md',
+            'For scopes and rate limits, see the "Authentication & rate limits" section of the ebay-mcp README.',
         inputSchema: exchangeAuthorizationCodeInputSchema.shape,
         outputSchema: {
             type: 'object',

package/build/tools/contracts.js

@@ -1,5 +1,5 @@
 import { getToolEntries } from '../tools/registry.js';
-import { isEffectBackedSchema } from '../utils/effectSchema.js';
+import { z } from 'zod';
 const isJsonObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 /**
  * Builds public tool contracts from the validated tool registry entries.
@@ -47,7 +47,7 @@ export const validateToolContracts = (contracts = getToolContracts()) => {
         }
         else {
             for (const [fieldName, schema] of Object.entries(contract.inputSchema)) {
-                if (!isEffectBackedSchema(schema)) {
+                if (!(schema instanceof z.ZodType)) {
                     invalidInputSchemaFields.push(`${contract.name}.${fieldName}`);
                 }
             }