@egain/egain-mcp-server 1.0.21 → 1.0.22

package/bin/mcp-server.js

@@ -4046,9 +4046,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.0.21",
+    sdkVersion: "1.0.22",
     genVersion: "2.723.8",
-    userAgent: "speakeasy-sdk/mcp-typescript 1.0.21 2.723.8 1.0.0 @egain/egain-mcp-server"
+    userAgent: "speakeasy-sdk/mcp-typescript 1.0.22 2.723.8 1.0.0 @egain/egain-mcp-server"
   };
 });
 
@@ -43078,8 +43078,8 @@ class PortalLookupHook {
 // src/hooks/server-routing-hook.ts
 class ServerRoutingHook {
   aiServicesOperations = new Set([
-    "post_/{portalID}/answers",
-    "post_/{portalID}/retrieve"
+    "getBestAnswer",
+    "retrieveChunks"
   ]);
   beforeCreateRequest(hookCtx, input) {
     const operationID = hookCtx.operationID;
@@ -44765,6 +44765,7 @@ var init_articletype = __esm(() => {
     "General",
     "Guided Help",
     "Data Link",
+    "PDF Content",
     "Topic Home",
     "Suggestion",
     "Virtual Assistant Action",
@@ -44919,13 +44920,23 @@ var init_taggroups = __esm(() => {
   });
 });
 
+// src/models/tag.ts
+var Tag$zodSchema;
+var init_tag = __esm(() => {
+  init_zod();
+  Tag$zodSchema = objectType({
+    id: stringType().optional(),
+    name: stringType().optional()
+  });
+});
+
 // src/models/tags.ts
 var Tags$zodSchema;
 var init_tags = __esm(() => {
   init_zod();
+  init_tag();
   Tags$zodSchema = objectType({
-    id: stringType().optional(),
-    tags: arrayType(stringType()).optional()
+    tag: arrayType(Tag$zodSchema).optional()
   });
 });
 
@@ -44984,8 +44995,10 @@ var init_personalization = __esm(() => {
 var TopicSummary$zodSchema;
 var init_topicsummary = __esm(() => {
   init_zod();
+  init_link();
   TopicSummary$zodSchema = objectType({
     id: stringType().optional(),
+    link: Link$zodSchema.optional(),
     name: stringType().optional()
   }).describe("This schema contains the topic ID and name of the topics. This is used by TopicBreadcrumb.");
 });
@@ -45144,6 +45157,17 @@ var init_languagequeryparameter = __esm(() => {
     "hr-HR",
     "ro-RO",
     "th-TH",
+    "de-AT",
+    "vi-VN",
+    "id-ID",
+    "ms-MY",
+    "fil-PH",
+    "fr-CA",
+    "hi-IN",
+    "uk-UA",
+    "bg-BG",
+    "sl-SI",
+    "sr-RS",
     "xx-XX"
   ]).describe("The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>$lang</code> is not passed, then the portal's default language is used.</li><br><br>**Important**: When using this API via SDK or MCP, use the parameter name `Dollar_lang`, not `$lang` or `lang`.");
 });
@@ -45172,7 +45196,7 @@ var init_wserrorcommon = __esm(() => {
     details: arrayType(lazyType(() => Detail$zodSchema)).optional(),
     developerMessage: stringType(),
     userMessage: stringType().optional()
-  }).describe("Error Schema");
+  }).describe("Bad Request");
 });
 
 // src/models/getannouncementarticlesop.ts
@@ -46047,7 +46071,19 @@ var init_mandatorylanguagequeryparameter = __esm(() => {
     "ar-SA",
     "hr-HR",
     "ro-RO",
-    "th-TH"
+    "th-TH",
+    "de-AT",
+    "vi-VN",
+    "id-ID",
+    "ms-MY",
+    "fil-PH",
+    "fr-CA",
+    "hi-IN",
+    "uk-UA",
+    "bg-BG",
+    "sl-SI",
+    "sr-RS",
+    "xx-XX"
   ]).describe("The language used for fetching the details of a resource. Resources available in different languages may differ from each other. **Important**: When using this API via SDK or MCP, use the parameter name `Dollar_lang`, not `$lang` or `lang`.");
 });
 
@@ -46310,10 +46346,22 @@ var init_createsuggestion = __esm(() => {
     "da-DK",
     "sv-SE",
     "ru-RU",
-    "fr-CA",
     "zh-CN",
     "ja-JP",
-    "ko-KR"
+    "ko-KR",
+    "de-AT",
+    "th-TH",
+    "vi-VN",
+    "id-ID",
+    "ms-MY",
+    "fil-PH",
+    "fr-CA",
+    "hi-IN",
+    "uk-UA",
+    "bg-BG",
+    "sk-SK",
+    "sl-SI",
+    "sr-RS"
   ]).describe("The code of the language.");
   Language$zodSchema = objectType({
     code: Code$zodSchema
@@ -46481,35 +46529,65 @@ Users can submit suggestions with details about what they're looking for, which
 });
 
 // src/models/answersrequest.ts
-var AnswersRequestType$zodSchema, AnswersRequestChannel$zodSchema, Context$zodSchema, AnswersRequest$zodSchema;
+var AnswersRequestType$zodSchema, AnswersRequestChannel$zodSchema, AnswersRequest$zodSchema;
 var init_answersrequest = __esm(() => {
   init_zod();
   AnswersRequestType$zodSchema = enumType([
     "portal",
     "custom"
-  ]).describe("The channel where the query originated, e.g., directly from the portal or via a custom integration.");
+  ]).describe(`Optional channel type. Defaults to "portal" if omitted. 
+` + `Accepts "portal" or "custom". Only include if channel object is provided.
+` + "");
   AnswersRequestChannel$zodSchema = objectType({
     name: stringType().default("portal"),
     type: AnswersRequestType$zodSchema.default("portal")
-  });
-  Context$zodSchema = objectType({
-    companyContext: stringType().optional(),
-    pageContext: stringType().optional(),
-    userContext: stringType().optional()
-  }).describe("Additional contextual metadata that enriches the query, providing the LLM with relevant details for tailoring the response.");
+  }).describe(`**Optional** channel information. **Recommended: Omit this field** unless specifically needed.
+` + `
+` + `**Important Notes:**
+` + `- The API works reliably without this field (defaults are applied automatically)
+` + `- Including channel may cause validation errors (400 Bad Request) in some cases
+` + `- If you receive a 400 error when including channel, retry the request without it
+` + `- When channel is provided, both type and name are optional, but name should be non-empty if provided
+` + `
+` + `**Working examples:**
+` + `- Omit channel entirely (recommended)
+` + `- channel: {type: "portal", name: "portal"}
+` + `- channel: {type: "custom", name: "test"}
+` + `- channel: {name: "portal"} (type defaults to "portal")
+` + "");
   AnswersRequest$zodSchema = objectType({
     channel: lazyType(() => AnswersRequestChannel$zodSchema).optional(),
-    context: lazyType(() => Context$zodSchema).optional(),
+    clientSessionId: stringType().optional(),
     eventId: stringType(),
     sessionId: stringType()
   });
 });
 
+// src/models/aitopicsummary.ts
+var AITopicSummary$zodSchema;
+var init_aitopicsummary = __esm(() => {
+  init_zod();
+  AITopicSummary$zodSchema = objectType({
+    id: stringType().optional(),
+    name: stringType().optional()
+  }).describe("This schema contains the topic ID and name of the topics. This is used by TopicBreadcrumb.");
+});
+
+// src/models/aitopicbreadcrumb.ts
+var AITopicBreadcrumb$zodSchema;
+var init_aitopicbreadcrumb = __esm(() => {
+  init_zod();
+  init_aitopicsummary();
+  AITopicBreadcrumb$zodSchema = objectType({
+    topicSummary: arrayType(AITopicSummary$zodSchema).optional()
+  }).describe("This schema contains one or more TopicSummary instances.");
+});
+
 // src/models/referenceresponse.ts
 var ReferenceResponseDocType$zodSchema, ReferenceResponseSource$zodSchema, ReferenceResponse$zodSchema;
 var init_referenceresponse = __esm(() => {
   init_zod();
-  init_topicbreadcrumb();
+  init_aitopicbreadcrumb();
   ReferenceResponseDocType$zodSchema = enumType([
     "HTML",
     "DOCX",
@@ -46526,7 +46604,7 @@ var init_referenceresponse = __esm(() => {
     id: stringType(),
     name: stringType(),
     source: ReferenceResponseSource$zodSchema,
-    topicBreadcrumb: arrayType(TopicBreadcrumb$zodSchema).optional()
+    topicBreadcrumb: arrayType(AITopicBreadcrumb$zodSchema).optional()
   }).describe("One document used in generated response");
 });
 
@@ -46534,7 +46612,7 @@ var init_referenceresponse = __esm(() => {
 var SearchResultDocType$zodSchema, SearchResultSource$zodSchema, SearchResult$zodSchema;
 var init_searchresult = __esm(() => {
   init_zod();
-  init_topicbreadcrumb();
+  init_aitopicbreadcrumb();
   SearchResultDocType$zodSchema = enumType([
     "HTML",
     "DOCX",
@@ -46544,16 +46622,18 @@ var init_searchresult = __esm(() => {
   SearchResultSource$zodSchema = enumType([
     "eGain Article",
     "eGain Attachment"
-  ]).describe("The repository or system where the content originated (e.g., eGain, SharePoint).");
+  ]).describe("The repository or system where the content originated (e.g., eGain Article, eGain Attachment).");
   SearchResult$zodSchema = objectType({
+    contextualSummary: stringType().optional(),
     docName: stringType().optional(),
     docType: SearchResultDocType$zodSchema,
     id: stringType(),
     name: stringType(),
-    relevanceScore: numberType(),
+    normalizedScore: numberType().optional(),
+    relevanceScore: numberType().optional(),
     snippet: stringType(),
     source: SearchResultSource$zodSchema,
-    topicBreadcrumb: arrayType(TopicBreadcrumb$zodSchema).optional()
+    topicBreadcrumb: arrayType(AITopicBreadcrumb$zodSchema).optional()
   }).describe("Represents a single document or snippet returned by search, along with its metadata and relevance score.");
 });
 
@@ -46571,7 +46651,7 @@ var init_answersresponse = __esm(() => {
     answerType: AnswersResponseAnswerType$zodSchema,
     answerValue: stringType(),
     references: arrayType(ReferenceResponse$zodSchema),
-    relevanceScore: numberType()
+    relevanceScore: numberType().optional()
   });
   AnswersResponseType$zodSchema = enumType([
     "portal",
@@ -46584,17 +46664,18 @@ var init_answersresponse = __esm(() => {
   AnswersResponse$zodSchema = objectType({
     answer: lazyType(() => AnswersResponseAnswer$zodSchema),
     channel: lazyType(() => AnswersResponseChannel$zodSchema).optional(),
+    clientSessionId: stringType().optional(),
     eventId: stringType().optional(),
     searchResults: arrayType(SearchResult$zodSchema),
     sessionId: stringType()
   });
 });
 
-// src/models/languagecodeparameter.ts
-var LanguageCodeParameter$zodSchema;
-var init_languagecodeparameter = __esm(() => {
+// src/models/requiredlanguagecode.ts
+var RequiredLanguageCode$zodSchema;
+var init_requiredlanguagecode = __esm(() => {
   init_zod();
-  LanguageCodeParameter$zodSchema = enumType([
+  RequiredLanguageCode$zodSchema = enumType([
     "en-US",
     "fr-FR",
     "en-GB",
@@ -46626,28 +46707,33 @@ var init_languagecodeparameter = __esm(() => {
     "ro-RO",
     "th-TH",
     "xx-XX"
-  ]).describe("The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>$lang</code> is not passed, then the portal's default language is used.</li><br><br>**Important**: When using this API via SDK or MCP, use the parameter name `Dollar_lang`, not `$lang` or `lang`.");
+  ]).describe("The language that describes the details of a resource. Resources available in different languages may differ from each other.");
 });
 
-// src/models/postportalidanswersop.ts
-var PostPortalIDAnswersRequest$zodSchema, PostPortalIDAnswersResponse$zodSchema;
-var init_postportalidanswersop = __esm(() => {
+// src/models/getbestanswerop.ts
+var GetBestAnswerRequest$zodSchema, GetBestAnswerResponse$zodSchema;
+var init_getbestanswerop = __esm(() => {
   init_zod();
   init_answersrequest();
   init_answersresponse();
-  init_languagecodeparameter();
-  PostPortalIDAnswersRequest$zodSchema = objectType({
+  init_requiredlanguagecode();
+  GetBestAnswerRequest$zodSchema = objectType({
     AnswersRequest: AnswersRequest$zodSchema.optional(),
-    Dollar_lang: LanguageCodeParameter$zodSchema.default("en-US"),
+    Dollar_lang: RequiredLanguageCode$zodSchema,
     dollarFilterTags: recordType(arrayType(stringType())).describe(`An object where each key is a **Category Tag ID** (numeric string),  
 ` + `and each value is an array of **Tag IDs** for that category.
+` + ` **Note**:
+` + `  - The '$filter[tags]' query parameter JSON value should be url encoded.
+` + `  - Some developer tools for invoking APIs may not url encode the '$filter[tags]' query parameter JSON value by default. Ensure that only url encoded values are used.
+` + `  - Example of JSON value: {"BASE-40845":["BASE-40849","BASE-40853"]}
+` + `  - Example of URL encoded value: %7B%22BASE-40845%22%3A%5B%22BASE-40849%22%2C%22BASE-40853%22%5D%7D
 ` + "").optional(),
-    dollarFilterTopicIds: arrayType(stringType()).optional(),
+    dollarFilterTopicIds: arrayType(stringType()).describe("An array of topic IDs. It is used to restrict search results to specific topics.").optional(),
     dollarFilterUserProfileID: stringType().optional(),
     portalID: stringType().describe("The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."),
     q: stringType().describe("The search query string.")
   });
-  PostPortalIDAnswersResponse$zodSchema = objectType({
+  GetBestAnswerResponse$zodSchema = objectType({
     AnswersResponse: AnswersResponse$zodSchema.optional(),
     ContentType: stringType(),
     RawResponse: instanceOfType(Response),
@@ -46660,7 +46746,7 @@ function queryAnswers(client$, request, options) {
   return new APIPromise($do6(client$, request, options));
 }
 async function $do6(client$, request, options) {
-  const parsed$ = safeParse(request, (value$) => PostPortalIDAnswersRequest$zodSchema.parse(value$), "Input validation failed");
+  const parsed$ = safeParse(request, (value$) => GetBestAnswerRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
@@ -46689,7 +46775,7 @@ async function $do6(client$, request, options) {
   const context = {
     options: client$._options,
     baseURL: options?.serverURL ?? client$._baseURL ?? "",
-    operationID: "post_/{portalID}/answers",
+    operationID: "getBestAnswer",
     oAuth2Scopes: null,
     resolvedSecurity: requestSecurity,
     securitySource: client$._options.security,
@@ -46730,9 +46816,7 @@ async function $do6(client$, request, options) {
   const responseFields$ = {
     HttpMeta: { Response: response, Request: req$ }
   };
-  const [result$] = await match(json(200, PostPortalIDAnswersResponse$zodSchema, {
-    key: "AnswersResponse"
-  }), nil(400, PostPortalIDAnswersResponse$zodSchema), nil(500, PostPortalIDAnswersResponse$zodSchema))(response, req$, { extraFields: responseFields$ });
+  const [result$] = await match(json(200, GetBestAnswerResponse$zodSchema, { key: "AnswersResponse" }), nil(400, GetBestAnswerResponse$zodSchema), nil(500, GetBestAnswerResponse$zodSchema))(response, req$, { extraFields: responseFields$ });
   return [result$, { status: "complete", request: req$, response }];
 }
 var init_queryAnswers = __esm(() => {
@@ -46742,7 +46826,7 @@ var init_queryAnswers = __esm(() => {
   init_schemas();
   init_security();
   init_url();
-  init_postportalidanswersop();
+  init_getbestanswerop();
   init_async();
 });
 
@@ -46750,14 +46834,14 @@ var init_queryAnswers = __esm(() => {
 var args6, tool$queryAnswers;
 var init_queryAnswers2 = __esm(() => {
   init_queryAnswers();
-  init_postportalidanswersop();
+  init_getbestanswerop();
   init_tools();
   args6 = {
-    request: PostPortalIDAnswersRequest$zodSchema
+    request: GetBestAnswerRequest$zodSchema
   };
   tool$queryAnswers = {
     name: "query-answers",
-    description: `Get the best answer for a user query
+    description: `Generate an Answer
 
 Get Answers
 
@@ -46769,6 +46853,10 @@ Get Answers
 The Answers API enables users to get the best answer for a user query. This API can return certified answers or generative answers along with search results, providing users with comprehensive responses to their questions.
 
 The API leverages AI capabilities to provide intelligent answers based on the knowledge base content, making it easier for users to find the information they need quickly and accurately.
+
+## Request Body Notes
+- **channel field**: Optional. **Recommended to omit** unless specifically needed. The API works reliably without it. If you receive a 400 Bad Request error when including channel, retry the request without the channel field.
+- **Required fields**: eventId and sessionId are required in the request body.
 `,
     annotations: {
       destructiveHint: false,
@@ -46805,6 +46893,7 @@ var init_retrieverequest = __esm(() => {
   });
   RetrieveRequest$zodSchema = objectType({
     channel: lazyType(() => RetrieveRequestChannel$zodSchema).optional(),
+    clientSessionId: stringType().optional(),
     eventId: stringType().optional(),
     sessionId: stringType().optional()
   });
@@ -46823,7 +46912,7 @@ var init_retrieveresponse = __esm(() => {
     answerType: RetrieveResponseAnswerType$zodSchema,
     answerValue: stringType(),
     references: arrayType(ReferenceResponse$zodSchema),
-    relevanceScore: numberType()
+    relevanceScore: numberType().optional()
   }).describe("If a certified answer is given. The answer object will be present. <br><br> This will be shown only if certified answers are configured and the certified answer meets the configured threshold.");
   RetrieveResponseType$zodSchema = enumType([
     "portal",
@@ -46836,37 +46925,41 @@ var init_retrieveresponse = __esm(() => {
   RetrieveResponse$zodSchema = objectType({
     answer: lazyType(() => RetrieveResponseAnswer$zodSchema).optional(),
     channel: lazyType(() => RetrieveResponseChannel$zodSchema).optional(),
+    clientSessionId: stringType().optional(),
     eventId: stringType().optional(),
     searchResults: arrayType(SearchResult$zodSchema),
     sessionId: stringType()
   });
 });
 
-// src/models/postportalidretrieveop.ts
-var PostPortalIDRetrieveRequest$zodSchema, PostPortalIDRetrieveResponse$zodSchema;
-var init_postportalidretrieveop = __esm(() => {
+// src/models/retrievechunksop.ts
+var RetrieveChunksRequest$zodSchema, RetrieveChunksResponse$zodSchema;
+var init_retrievechunksop = __esm(() => {
   init_zod();
-  init_languagecodeparameter();
+  init_requiredlanguagecode();
   init_retrieverequest();
   init_retrieveresponse();
-  init_wserrorcommon();
-  PostPortalIDRetrieveRequest$zodSchema = objectType({
-    Dollar_lang: LanguageCodeParameter$zodSchema.default("en-US"),
+  RetrieveChunksRequest$zodSchema = objectType({
+    Dollar_lang: RequiredLanguageCode$zodSchema,
     RetrieveRequest: RetrieveRequest$zodSchema.optional(),
     dollarFilterTags: recordType(arrayType(stringType())).describe(`An object where each key is a **Category Tag ID** (numeric string),  
 ` + `and each value is an array of **Tag IDs** for that category.
+` + ` **Note**:
+` + `  - The '$filter[tags]' query parameter JSON value should be url encoded.
+` + `  - Some developer tools for invoking APIs may not url encode the '$filter[tags]' query parameter JSON value by default. Ensure that only url encoded values are used.
+` + `  - Example of JSON value: {"BASE-40845":["BASE-40849","BASE-40853"]}
+` + `  - Example of URL encoded value: %7B%22BASE-40845%22%3A%5B%22BASE-40849%22%2C%22BASE-40853%22%5D%7D
 ` + "").optional(),
-    dollarFilterTopicIds: arrayType(stringType()).optional(),
+    dollarFilterTopicIds: arrayType(stringType()).describe("An array of topic IDs. It is used to restrict search results to specific topics.").optional(),
     dollarFilterUserProfileID: stringType().optional(),
     portalID: stringType().describe("The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."),
     q: stringType().describe("The search query string.")
   });
-  PostPortalIDRetrieveResponse$zodSchema = objectType({
+  RetrieveChunksResponse$zodSchema = objectType({
     ContentType: stringType(),
     RawResponse: instanceOfType(Response),
     RetrieveResponse: RetrieveResponse$zodSchema.optional(),
-    StatusCode: numberType().int(),
-    WSErrorCommon: WSErrorCommon$zodSchema.optional()
+    StatusCode: numberType().int()
   });
 });
 
@@ -46875,7 +46968,7 @@ function queryRetrieve(client$, request, options) {
   return new APIPromise($do7(client$, request, options));
 }
 async function $do7(client$, request, options) {
-  const parsed$ = safeParse(request, (value$) => PostPortalIDRetrieveRequest$zodSchema.parse(value$), "Input validation failed");
+  const parsed$ = safeParse(request, (value$) => RetrieveChunksRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
@@ -46904,7 +46997,7 @@ async function $do7(client$, request, options) {
   const context = {
     options: client$._options,
     baseURL: options?.serverURL ?? client$._baseURL ?? "",
-    operationID: "post_/{portalID}/retrieve",
+    operationID: "retrieveChunks",
     oAuth2Scopes: null,
     resolvedSecurity: requestSecurity,
     securitySource: client$._options.security,
@@ -46945,13 +47038,7 @@ async function $do7(client$, request, options) {
   const responseFields$ = {
     HttpMeta: { Response: response, Request: req$ }
   };
-  const [result$] = await match(json(200, PostPortalIDRetrieveResponse$zodSchema, {
-    key: "RetrieveResponse"
-  }), json(400, PostPortalIDRetrieveResponse$zodSchema, {
-    key: "WSErrorCommon"
-  }), json(500, PostPortalIDRetrieveResponse$zodSchema, {
-    key: "WSErrorCommon"
-  }))(response, req$, { extraFields: responseFields$ });
+  const [result$] = await match(json(200, RetrieveChunksResponse$zodSchema, { key: "RetrieveResponse" }), nil(400, RetrieveChunksResponse$zodSchema), nil(500, RetrieveChunksResponse$zodSchema))(response, req$, { extraFields: responseFields$ });
   return [result$, { status: "complete", request: req$, response }];
 }
 var init_queryRetrieve = __esm(() => {
@@ -46961,7 +47048,7 @@ var init_queryRetrieve = __esm(() => {
   init_schemas();
   init_security();
   init_url();
-  init_postportalidretrieveop();
+  init_retrievechunksop();
   init_async();
 });
 
@@ -46969,10 +47056,10 @@ var init_queryRetrieve = __esm(() => {
 var args7, tool$queryRetrieve;
 var init_queryRetrieve2 = __esm(() => {
   init_queryRetrieve();
-  init_postportalidretrieveop();
+  init_retrievechunksop();
   init_tools();
   args7 = {
-    request: PostPortalIDRetrieveRequest$zodSchema
+    request: RetrieveChunksRequest$zodSchema
   };
   tool$queryRetrieve = {
     name: "query-retrieve",
@@ -47012,6 +47099,19 @@ By leveraging the Retrieve API, organizations can build tailored experiences whi
   };
 });
 
+// src/models/aispaginationinfo.ts
+var AISPaginationInfo$zodSchema;
+var init_aispaginationinfo = __esm(() => {
+  init_zod();
+  init_link();
+  AISPaginationInfo$zodSchema = objectType({
+    count: numberType().int().default(1),
+    link: arrayType(Link$zodSchema).optional(),
+    pagenum: numberType().int().default(1),
+    pagesize: numberType().int().default(20)
+  });
+});
+
 // src/models/additionalsnippets.ts
 var AdditionalSnippetsDocType$zodSchema, AdditionalSnippets$zodSchema;
 var init_additionalsnippets = __esm(() => {
@@ -47028,99 +47128,173 @@ var init_additionalsnippets = __esm(() => {
     id: stringType(),
     keywordSnippet: stringType().optional(),
     name: stringType(),
-    relevanceScore: numberType(),
+    normalizedScore: numberType().optional(),
+    relevanceScore: numberType().optional(),
     snippet: stringType()
   });
 });
 
-// src/models/articlesearchresult.ts
-var ArticleSearchResultDocType$zodSchema, ArticleSearchResultSource$zodSchema, ArticleSearchResultType$zodSchema, ArticleSearchResultCustomAttribute$zodSchema, ArticleTypeAttributes$zodSchema, ArticleSearchResult$zodSchema;
-var init_articlesearchresult = __esm(() => {
+// src/models/schemastags.ts
+var SchemasTags$zodSchema;
+var init_schemastags = __esm(() => {
+  init_zod();
+  SchemasTags$zodSchema = objectType({
+    id: stringType().optional(),
+    tags: arrayType(stringType()).optional()
+  });
+});
+
+// src/models/articleaisearchresult.ts
+var ArticleAISearchResultDocType$zodSchema, ArticleAISearchResultSource$zodSchema, ArticleAISearchResultType$zodSchema, ArticleAISearchResultCustomAttribute$zodSchema, ArticleTypeAttributes$zodSchema, ArticleAISearchResult$zodSchema;
+var init_articleaisearchresult = __esm(() => {
   init_zod();
   init_additionalsnippets();
-  init_tags();
-  init_topicbreadcrumb();
-  ArticleSearchResultDocType$zodSchema = enumType([
+  init_aitopicbreadcrumb();
+  init_schemastags();
+  ArticleAISearchResultDocType$zodSchema = enumType([
     "HTML",
     "DOCX",
     "PDF",
     "PPTX"
   ]).describe("Format of the source document (HTML, DOCX, PPTX or PDF).");
-  ArticleSearchResultSource$zodSchema = enumType([
+  ArticleAISearchResultSource$zodSchema = enumType([
     "eGain Article",
     "eGain Attachment"
   ]).describe("The source type.");
-  ArticleSearchResultType$zodSchema = enumType([
+  ArticleAISearchResultType$zodSchema = enumType([
     "STRING",
     "INTEGER",
     "BOOLEAN",
     "DATETIME"
   ]).describe("The custom attribute's type.");
-  ArticleSearchResultCustomAttribute$zodSchema = objectType({
+  ArticleAISearchResultCustomAttribute$zodSchema = objectType({
     name: stringType().optional(),
-    type: ArticleSearchResultType$zodSchema.optional(),
+    type: ArticleAISearchResultType$zodSchema.optional(),
     value: arrayType(stringType()).optional()
   });
   ArticleTypeAttributes$zodSchema = objectType({
-    articleTypeId: stringType().optional(),
+    articleTypeId: anyType().optional(),
     typeName: stringType().optional()
   }).describe("The type of the Article and its attributes.");
-  ArticleSearchResult$zodSchema = objectType({
+  ArticleAISearchResult$zodSchema = objectType({
     additionalSnippetCount: numberType().int().optional(),
     additionalSnippets: arrayType(AdditionalSnippets$zodSchema).optional(),
     articleTypeAttributes: lazyType(() => ArticleTypeAttributes$zodSchema).optional(),
     contextualSummary: stringType().optional(),
-    customAttributes: arrayType(lazyType(() => ArticleSearchResultCustomAttribute$zodSchema)).optional(),
+    customAttributes: arrayType(lazyType(() => ArticleAISearchResultCustomAttribute$zodSchema)).optional(),
     docName: stringType().optional(),
-    docType: ArticleSearchResultDocType$zodSchema,
+    docType: ArticleAISearchResultDocType$zodSchema,
     headerPath: stringType().optional(),
     id: stringType(),
     keywordSnippet: stringType().optional(),
     modifiedDate: stringType().optional(),
     name: stringType(),
-    relevanceScore: numberType(),
-    snippet: stringType().optional(),
-    source: ArticleSearchResultSource$zodSchema,
-    tagCategories: arrayType(Tags$zodSchema).optional(),
-    topicBreadcrumb: arrayType(TopicBreadcrumb$zodSchema)
+    normalizedScore: numberType().optional(),
+    relevanceScore: numberType().optional(),
+    snippet: stringType(),
+    source: ArticleAISearchResultSource$zodSchema,
+    tagCategories: arrayType(SchemasTags$zodSchema).optional(),
+    topicBreadcrumb: arrayType(AITopicBreadcrumb$zodSchema)
   }).describe("Represents a single document or snippet returned by search, along with its metadata and relevance score.");
 });
 
-// src/models/searchresponse.ts
-var SearchResults$zodSchema, SearchResponse$zodSchema;
-var init_searchresponse = __esm(() => {
+// src/models/aisearchresponse.ts
+var SearchResults$zodSchema, AISearchResponse$zodSchema;
+var init_aisearchresponse = __esm(() => {
   init_zod();
-  init_articlesearchresult();
+  init_aispaginationinfo();
+  init_articleaisearchresult();
   SearchResults$zodSchema = objectType({
-    article: arrayType(ArticleSearchResult$zodSchema).optional()
+    article: arrayType(ArticleAISearchResult$zodSchema).optional()
   }).describe("Top search results with relevance scores");
-  SearchResponse$zodSchema = objectType({
+  AISearchResponse$zodSchema = objectType({
+    paginationInfo: AISPaginationInfo$zodSchema.optional(),
     searchResults: lazyType(() => SearchResults$zodSchema)
   });
 });
 
+// src/models/languagecodeparameter.ts
+var LanguageCodeParameter$zodSchema;
+var init_languagecodeparameter = __esm(() => {
+  init_zod();
+  LanguageCodeParameter$zodSchema = enumType([
+    "en-US",
+    "fr-FR",
+    "en-GB",
+    "es-ES",
+    "it-IT",
+    "nl-NL",
+    "da-DA",
+    "sv-SE",
+    "pt-PT",
+    "fi-FI",
+    "no-NB",
+    "no-NN",
+    "ja-JA",
+    "de-DE",
+    "pt-BR",
+    "zh-CN",
+    "zh-TW",
+    "ko-KO",
+    "ru-RU",
+    "el-EL",
+    "tr-TR",
+    "pl-PL",
+    "cs-CS",
+    "sk-SK",
+    "hu-HU",
+    "sr-SR",
+    "ar-SA",
+    "hr-HR",
+    "ro-RO",
+    "th-TH",
+    "de-AT",
+    "vi-VN",
+    "id-ID",
+    "ms-MY",
+    "fil-PH",
+    "fr-CA",
+    "hi-IN",
+    "uk-UA",
+    "bg-BG",
+    "sl-SI",
+    "sr-RS",
+    "xx-XX"
+  ]).describe("The language that describes the details of a resource. Resources available in different languages may differ from each other.<li>If <code>$lang</code> is not passed, then the portal's default language is used.</li><br><br>**Important**: When using this API via SDK or MCP, use the parameter name `Dollar_lang`, not `$lang` or `lang`.");
+});
+
 // src/models/aisearchop.ts
-var AiSearchRequest$zodSchema, AiSearchResponse$zodSchema;
+var AiSearchRequest$zodSchema, AiSearchResponseResponse$zodSchema;
 var init_aisearchop = __esm(() => {
   init_zod();
+  init_aisearchresponse();
   init_languagecodeparameter();
-  init_searchresponse();
+  init_wserrorcommon();
   AiSearchRequest$zodSchema = objectType({
     Dollar_lang: LanguageCodeParameter$zodSchema.default("en-US"),
+    Dollar_pagenum: numberType().int().default(1).describe("Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."),
+    Dollar_pagesize: numberType().int().default(20).describe("Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."),
     articleCustomAdditionalAttributes: stringType().describe("One or more comma-separated names for article custom attributes defined by the user to be returned.").optional(),
     dollarFilterTags: recordType(arrayType(stringType())).describe(`An object where each key is a **Category Tag ID** (numeric string),  
 ` + `and each value is an array of **Tag IDs** for that category.
+` + ` **Note**:
+` + `  - The '$filter[tags]' query parameter JSON value should be url encoded.
+` + `  - Some developer tools for invoking APIs may not url encode the '$filter[tags]' query parameter JSON value by default. Ensure that only url encoded values are used.
+` + `  - Example of JSON value: {"BASE-40845":["BASE-40849","BASE-40853"]}
+` + `  - Example of URL encoded value: %7B%22BASE-40845%22%3A%5B%22BASE-40849%22%2C%22BASE-40853%22%5D%7D
+` + "").optional(),
+    dollarFilterTopicIds: arrayType(stringType()).describe("An array of topic IDs. It is used to restrict search results to specific topics.").optional(),
+    dollarFilterUserProfileID: stringType().describe(`The ID of the user profile. 
 ` + "").optional(),
-    dollarFilterTopicIds: arrayType(stringType()).optional(),
-    dollarFilterUserProfileID: stringType().describe("The Readable ID of the user profile.").optional(),
     portalID: stringType().describe("The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."),
-    q: stringType().describe("The search query string.")
+    q: stringType().describe("The search query string. The string must be escaped as required by the URL syntax rules.")
   });
-  AiSearchResponse$zodSchema = objectType({
+  AiSearchResponseResponse$zodSchema = objectType({
+    AISearchResponse: AISearchResponse$zodSchema.optional(),
     ContentType: stringType(),
     RawResponse: instanceOfType(Response),
-    SearchResponse: SearchResponse$zodSchema.optional(),
-    StatusCode: numberType().int()
+    StatusCode: numberType().int(),
+    WSErrorCommon: WSErrorCommon$zodSchema.optional()
   });
 });
 
@@ -47147,6 +47321,8 @@ async function $do8(client$, request, options) {
     "$filter[topicIds]": payload$.dollarFilterTopicIds,
     "$filter[userProfileID]": payload$.dollarFilterUserProfileID,
     $lang: payload$.Dollar_lang,
+    $pagenum: payload$.Dollar_pagenum,
+    $pagesize: payload$.Dollar_pagesize,
     articleCustomAdditionalAttributes: payload$.articleCustomAdditionalAttributes,
     q: payload$.q
   });
@@ -47199,7 +47375,11 @@ async function $do8(client$, request, options) {
   const responseFields$ = {
     HttpMeta: { Response: response, Request: req$ }
   };
-  const [result$] = await match(json(200, AiSearchResponse$zodSchema, { key: "SearchResponse" }), nil(400, AiSearchResponse$zodSchema), nil(500, AiSearchResponse$zodSchema))(response, req$, { extraFields: responseFields$ });
+  const [result$] = await match(json(200, AiSearchResponseResponse$zodSchema, {
+    key: "AISearchResponse"
+  }), nil(204, AiSearchResponseResponse$zodSchema), json([400, 401, 403, 404, 406], AiSearchResponseResponse$zodSchema, {
+    key: "WSErrorCommon"
+  }), json(500, AiSearchResponseResponse$zodSchema, { key: "WSErrorCommon" }))(response, req$, { extraFields: responseFields$ });
   return [result$, { status: "complete", request: req$, response }];
 }
 var init_querySearch = __esm(() => {
@@ -47224,7 +47404,7 @@ var init_querySearch2 = __esm(() => {
   };
   tool$querySearch = {
     name: "query-search",
-    description: `Get the best search results for a user query
+    description: `Hybrid Search
 
 The Search API is a hybrid search service that combines semantic understanding with keyword precision to deliver fast, contextual, and relevant results from your enterprise knowledge base. It enables secure, role-aware access to articles, FAQs, and documentation across customer, agent, and employee interfaces. Each query returns a ranked list of results with snippets, metadata, and relevance scores. <br>**This endpoint is only available for Self Service environments.**
 `,
@@ -47253,7 +47433,7 @@ The Search API is a hybrid search service that combines semantic understanding w
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "EgainMcp",
-    version: "1.0.21"
+    version: "1.0.22"
   });
   const getClient = deps.getSDK || (() => new EgainMcpCore({
     security: deps.security,
@@ -47273,14 +47453,14 @@ function createMCPServer(deps) {
   const resourceTemplate = createRegisterResourceTemplate(deps.logger, server, getClient, scopes);
   const prompt = createRegisterPrompt(deps.logger, server, getClient, scopes);
   const register = { tool, resource, resourceTemplate, prompt };
+  tool(tool$queryRetrieve);
+  tool(tool$queryAnswers);
   tool(tool$getArticle);
   tool(tool$getAnnouncements);
   tool(tool$getPopularArticles);
   tool(tool$getPortals);
-  tool(tool$makeSuggestion);
-  tool(tool$queryAnswers);
   tool(tool$querySearch);
-  tool(tool$queryRetrieve);
+  tool(tool$makeSuggestion);
   return server;
 }
 var init_server2 = __esm(() => {
@@ -48500,7 +48680,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "1.0.21"
+    currentVersion: "1.0.22"
   }
 });
 Yt(app, process3.argv.slice(2), buildContext(process3));
@@ -48508,5 +48688,5 @@ export {
   app
 };
 
-//# debugId=5B9FCC5C797D0C8264756E2164756E21
+//# debugId=02EDC3F243E098BE64756E2164756E21
 //# sourceMappingURL=mcp-server.js.map