@youdotcom-oss/mcp 1.5.0 → 1.6.0

package/src/search/search.schemas.ts

@@ -1,147 +0,0 @@
-import * as z from 'zod';
-
-export const SearchQuerySchema = z.object({
-  query: z.string().min(1, 'Query is required').describe('Search query (supports +, -, site:, filetype:, lang:)'),
-  count: z.number().int().min(1).max(100).optional().describe('Max results per section'),
-  freshness: z.string().optional().describe('day/week/month/year or YYYY-MM-DDtoYYYY-MM-DD'),
-  offset: z.number().int().min(0).max(9).optional().describe('Pagination offset'),
-  country: z
-    .enum([
-      'AR',
-      'AU',
-      'AT',
-      'BE',
-      'BR',
-      'CA',
-      'CL',
-      'DK',
-      'FI',
-      'FR',
-      'DE',
-      'HK',
-      'IN',
-      'ID',
-      'IT',
-      'JP',
-      'KR',
-      'MY',
-      'MX',
-      'NL',
-      'NZ',
-      'NO',
-      'CN',
-      'PL',
-      'PT',
-      'PH',
-      'RU',
-      'SA',
-      'ZA',
-      'ES',
-      'SE',
-      'CH',
-      'TW',
-      'TR',
-      'GB',
-      'US',
-    ])
-    .optional()
-    .describe('Country code'),
-  safesearch: z.enum(['off', 'moderate', 'strict']).optional().describe('Filter level'),
-  site: z.string().optional().describe('Specific domain'),
-  fileType: z.string().optional().describe('File type'),
-  language: z.string().optional().describe('ISO 639-1 language code'),
-  excludeTerms: z.string().optional().describe('Terms to exclude (pipe-separated)'),
-  exactTerms: z.string().optional().describe('Exact terms (pipe-separated)'),
-  livecrawl: z.enum(['web', 'news', 'all']).optional().describe('Live-crawl sections for full content'),
-  livecrawl_formats: z.enum(['html', 'markdown']).optional().describe('Format for crawled content'),
-});
-
-export type SearchQuery = z.infer<typeof SearchQuerySchema>;
-
-const WebResultSchema = z.object({
-  url: z.string().describe('URL'),
-  title: z.string().describe('Title'),
-  description: z.string().describe('Description'),
-  snippets: z.array(z.string()).describe('Content snippets'),
-  page_age: z.string().optional().describe('Publication timestamp'),
-  authors: z.array(z.string()).optional().describe('Authors'),
-  thumbnail_url: z.string().optional().describe('Thumbnail image URL'),
-  favicon_url: z.string().optional().describe('Favicon URL'),
-  contents: z
-    .object({
-      html: z.string().optional().describe('Full HTML content'),
-      markdown: z.string().optional().describe('Full Markdown content'),
-    })
-    .optional()
-    .describe('Live-crawled page content'),
-});
-
-const NewsResultSchema = z.object({
-  title: z.string().describe('Title'),
-  description: z.string().describe('Description'),
-  page_age: z.string().describe('Publication timestamp'),
-  url: z.string().describe('URL'),
-  thumbnail_url: z.string().optional().describe('Thumbnail image URL'),
-  contents: z
-    .object({
-      html: z.string().optional().describe('Full HTML content'),
-      markdown: z.string().optional().describe('Full Markdown content'),
-    })
-    .optional()
-    .describe('Live-crawled page content'),
-});
-
-export type NewsResult = z.infer<typeof NewsResultSchema>;
-
-const MetadataSchema = z.object({
-  search_uuid: z.string().optional().describe('Unique search request ID'),
-  query: z.string().describe('Query'),
-  latency: z.number().describe('Latency in seconds'),
-});
-
-export const SearchResponseSchema = z.object({
-  results: z.object({
-    web: z.array(WebResultSchema).optional(),
-    news: z.array(NewsResultSchema).optional(),
-  }),
-  metadata: MetadataSchema.partial(),
-});
-
-export type SearchResponse = z.infer<typeof SearchResponseSchema>;
-
-// Minimal schema for structuredContent (reduces payload duplication)
-// Excludes metadata (query, search_uuid, latency) as these are not actionable by LLM
-export const SearchStructuredContentSchema = z.object({
-  resultCounts: z.object({
-    web: z.number().describe('Web results'),
-    news: z.number().describe('News results'),
-    total: z.number().describe('Total results'),
-  }),
-  results: z
-    .object({
-      web: z
-        .array(
-          z.object({
-            url: z.string().describe('URL'),
-            title: z.string().describe('Title'),
-            page_age: z.string().optional().describe('Publication timestamp'),
-          }),
-        )
-        .optional()
-        .describe('Web results'),
-      news: z
-        .array(
-          z.object({
-            url: z.string().describe('URL'),
-            title: z.string().describe('Title'),
-            page_age: z.string().describe('Publication timestamp'),
-          }),
-        )
-        .optional()
-        .describe('News results'),
-    })
-    .optional()
-    .describe('Search results'),
-});
-
-export type SearchStructuredContent = z.infer<typeof SearchStructuredContentSchema>;

package/src/shared/api-constants.ts

@@ -1,10 +0,0 @@
-/**
- * You.com API endpoints
- *
- * These constants define the base URLs for You.com's APIs.
- * Exported for use in tests and external packages.
- */
-
-export const SEARCH_API_URL = 'https://ydc-index.io/v1/search';
-export const EXPRESS_API_URL = 'https://api.you.com/v1/agents/runs';
-export const CONTENTS_API_URL = 'https://ydc-index.io/v1/contents';

package/src/shared/check-response-for-errors.ts

@@ -1,13 +0,0 @@
-/**
- * Checks if a response object contains an error field and throws if found
- * Handles API responses that return 200 status but contain error messages
- * Used by both search and express agent utilities
- */
-export const checkResponseForErrors = (responseData: unknown) => {
-  if (typeof responseData === 'object' && responseData !== null && 'error' in responseData) {
-    const errorMessage =
-      typeof responseData.error === 'string' ? responseData.error : JSON.stringify(responseData.error);
-    throw new Error(`You.com API Error: ${errorMessage}`);
-  }
-  return responseData;
-};

package/src/shared/generate-error-report-link.ts

@@ -1,37 +0,0 @@
-import packageJson from '../../package.json' with { type: 'json' };
-/**
- * Generates a mailto link for error reporting with pre-filled context
- * Used by tool error handlers to provide easy error reporting
- */
-export const generateErrorReportLink = ({
-  errorMessage,
-  tool,
-  clientInfo,
-}: {
-  errorMessage: string;
-  tool: string;
-  clientInfo: string;
-}): string => {
-  const subject = `MCP Server Issue v${packageJson.version}`;
-  const body = `Server Version: v${packageJson.version}
-Client: ${clientInfo}
-Tool: ${tool}
-
-Error Message:
-${errorMessage}
-
-Steps to Reproduce:
-1.
-2.
-3.
-
-Additional Context:
-`;
-
-  const params = new URLSearchParams({
-    subject,
-    body,
-  });
-
-  return `mailto:support@you.com?${params.toString()}`;
-};

package/src/tests/exports.spec.ts

@@ -1,24 +0,0 @@
-// src/tests/exports.spec.ts
-import { describe, expect, test } from 'bun:test';
-import * as exports from '@youdotcom-oss/mcp';
-
-describe('Package exports', () => {
-  test('should export all required schemas', async () => {
-    // Schemas
-    expect(exports.ContentsQuerySchema).toBeDefined();
-    expect(exports.ExpressAgentInputSchema).toBeDefined();
-    expect(exports.SearchQuerySchema).toBeDefined();
-
-    // Utilities
-    expect(exports.fetchContents).toBeDefined();
-    expect(exports.formatContentsResponse).toBeDefined();
-    expect(exports.callExpressAgent).toBeDefined();
-    expect(exports.formatExpressAgentResponse).toBeDefined();
-    expect(exports.fetchSearchResults).toBeDefined();
-    expect(exports.formatSearchResults).toBeDefined();
-
-    // Shared utilities
-    expect(exports.checkResponseForErrors).toBeDefined();
-    expect(exports.formatSearchResultsText).toBeDefined();
-  });
-});