@markstiles/sitecore-search-mcp 1.0.0

package/dist/tools/search/ai-search.d.ts

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import { SearchClient } from '../../client/search-client.js';
+/**
+ * Schema for AI-powered questions and answers
+ */
+export declare const AiSearchSchema: z.ZodObject<{
+    domainId: z.ZodString;
+    rfkId: z.ZodString;
+    keyphrase: z.ZodString;
+    entity: z.ZodOptional<z.ZodString>;
+    exact_answer: z.ZodOptional<z.ZodObject<{
+        include_sources: z.ZodOptional<z.ZodBoolean>;
+        query_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["question", "statement", "keyword"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        include_sources?: boolean | undefined;
+        query_types?: ("question" | "statement" | "keyword")[] | undefined;
+    }, {
+        include_sources?: boolean | undefined;
+        query_types?: ("question" | "statement" | "keyword")[] | undefined;
+    }>>;
+    related_questions: z.ZodOptional<z.ZodObject<{
+        include_sources: z.ZodOptional<z.ZodBoolean>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit?: number | undefined;
+        include_sources?: boolean | undefined;
+        offset?: number | undefined;
+    }, {
+        limit?: number | undefined;
+        include_sources?: boolean | undefined;
+        offset?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    domainId: string;
+    rfkId: string;
+    keyphrase: string;
+    entity?: string | undefined;
+    exact_answer?: {
+        include_sources?: boolean | undefined;
+        query_types?: ("question" | "statement" | "keyword")[] | undefined;
+    } | undefined;
+    related_questions?: {
+        limit?: number | undefined;
+        include_sources?: boolean | undefined;
+        offset?: number | undefined;
+    } | undefined;
+}, {
+    domainId: string;
+    rfkId: string;
+    keyphrase: string;
+    entity?: string | undefined;
+    exact_answer?: {
+        include_sources?: boolean | undefined;
+        query_types?: ("question" | "statement" | "keyword")[] | undefined;
+    } | undefined;
+    related_questions?: {
+        limit?: number | undefined;
+        include_sources?: boolean | undefined;
+        offset?: number | undefined;
+    } | undefined;
+}>;
+export type AiSearchInput = z.infer<typeof AiSearchSchema>;
+/**
+ * Get AI-powered answers or related questions
+ */
+export declare function getAiSearchResults(client: SearchClient, input: unknown): Promise<import("../../client/search-client.js").SearchResponse>;
+/**
+ * MCP Tool Definition for AI search features
+ */
+export declare const aiSearchTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        domainId: z.ZodString;
+        rfkId: z.ZodString;
+        keyphrase: z.ZodString;
+        entity: z.ZodOptional<z.ZodString>;
+        exact_answer: z.ZodOptional<z.ZodObject<{
+            include_sources: z.ZodOptional<z.ZodBoolean>;
+            query_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["question", "statement", "keyword"]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            include_sources?: boolean | undefined;
+            query_types?: ("question" | "statement" | "keyword")[] | undefined;
+        }, {
+            include_sources?: boolean | undefined;
+            query_types?: ("question" | "statement" | "keyword")[] | undefined;
+        }>>;
+        related_questions: z.ZodOptional<z.ZodObject<{
+            include_sources: z.ZodOptional<z.ZodBoolean>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            limit?: number | undefined;
+            include_sources?: boolean | undefined;
+            offset?: number | undefined;
+        }, {
+            limit?: number | undefined;
+            include_sources?: boolean | undefined;
+            offset?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        domainId: string;
+        rfkId: string;
+        keyphrase: string;
+        entity?: string | undefined;
+        exact_answer?: {
+            include_sources?: boolean | undefined;
+            query_types?: ("question" | "statement" | "keyword")[] | undefined;
+        } | undefined;
+        related_questions?: {
+            limit?: number | undefined;
+            include_sources?: boolean | undefined;
+            offset?: number | undefined;
+        } | undefined;
+    }, {
+        domainId: string;
+        rfkId: string;
+        keyphrase: string;
+        entity?: string | undefined;
+        exact_answer?: {
+            include_sources?: boolean | undefined;
+            query_types?: ("question" | "statement" | "keyword")[] | undefined;
+        } | undefined;
+        related_questions?: {
+            limit?: number | undefined;
+            include_sources?: boolean | undefined;
+            offset?: number | undefined;
+        } | undefined;
+    }>;
+};
+//# sourceMappingURL=ai-search.d.ts.map

package/dist/tools/search/ai-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-search.d.ts","sourceRoot":"","sources":["../../../src/tools/search/ai-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAoB5E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,mEA8Bf;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIxB,CAAC"}

package/dist/tools/search/ai-search.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { validateInput } from '../../utils/errors.js';
+/**
+ * Schema for exact answer configuration
+ */
+const ExactAnswerSchema = z.object({
+    include_sources: z.boolean().optional().describe('Whether to return specific attributes from documents used to generate the answer'),
+    query_types: z.array(z.enum(['question', 'statement', 'keyword'])).optional().describe('Type of visitor query to answer (question, statement, or keyword)'),
+});
+/**
+ * Schema for related questions configuration
+ */
+const RelatedQuestionsSchema = z.object({
+    include_sources: z.boolean().optional().describe('Include attributes from documents used to generate the answer'),
+    limit: z.number().int().min(1).max(100).optional().describe('Maximum number of question-answer pairs to return'),
+    offset: z.number().int().min(0).optional().describe('Number of items to skip'),
+});
+/**
+ * Schema for AI-powered questions and answers
+ */
+export const AiSearchSchema = z.object({
+    domainId: z.string().describe('Sitecore domain ID'),
+    rfkId: z.string().describe('RFK widget ID for questions (must be a questions widget type)'),
+    keyphrase: z.string().min(1).max(100).describe('Search query for AI processing'),
+    entity: z.string().optional().describe('Entity type'),
+    exact_answer: ExactAnswerSchema.optional().describe('Settings to get a single answer to the visitor query'),
+    related_questions: RelatedQuestionsSchema.optional().describe('Settings to get AI-generated question-and-answer pairs'),
+});
+/**
+ * Get AI-powered answers or related questions
+ */
+export async function getAiSearchResults(client, input) {
+    const params = validateInput(AiSearchSchema, input);
+    // Build the questions object for the API
+    const questions = {
+        keyphrase: params.keyphrase,
+    };
+    if (params.exact_answer) {
+        questions.exact_answer = params.exact_answer;
+    }
+    if (params.related_questions) {
+        questions.related_questions = params.related_questions;
+    }
+    const request = {
+        widget: {
+            items: [
+                {
+                    rfk_id: params.rfkId,
+                    entity: params.entity,
+                },
+            ],
+        },
+        questions,
+    };
+    return client.search(params.domainId, request);
+}
+/**
+ * MCP Tool Definition for AI search features
+ */
+export const aiSearchTool = {
+    name: 'sitecore_ai_search',
+    description: 'Get AI-powered exact answers or related questions for a search query. You must pass at least one of exact_answer or related_questions. Use a questions widget type in rfkId.',
+    inputSchema: AiSearchSchema,
+};
+//# sourceMappingURL=ai-search.js.map

package/dist/tools/search/ai-search.js.map

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

package/dist/tools/search/basic-search.d.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { SearchClient } from '../../client/search-client.js';
+/**
+ * Schema for basic search query
+ */
+export declare const BasicSearchSchema: z.ZodObject<{
+    domainId: z.ZodString;
+    rfkId: z.ZodString;
+    keyphrase: z.ZodOptional<z.ZodString>;
+    entity: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    locale: z.ZodOptional<z.ZodObject<{
+        language: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        language?: string | undefined;
+        country?: string | undefined;
+    }, {
+        language?: string | undefined;
+        country?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    domainId: string;
+    rfkId: string;
+    page: number;
+    limit: number;
+    entity?: string | undefined;
+    keyphrase?: string | undefined;
+    locale?: {
+        language?: string | undefined;
+        country?: string | undefined;
+    } | undefined;
+}, {
+    domainId: string;
+    rfkId: string;
+    entity?: string | undefined;
+    keyphrase?: string | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    locale?: {
+        language?: string | undefined;
+        country?: string | undefined;
+    } | undefined;
+}>;
+export type BasicSearchInput = z.infer<typeof BasicSearchSchema>;
+/**
+ * Execute a basic search query
+ */
+export declare function executeBasicSearch(client: SearchClient, input: unknown): Promise<import("../../client/search-client.js").SearchResponse>;
+/**
+ * MCP Tool Definition for basic search
+ */
+export declare const basicSearchTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        domainId: z.ZodString;
+        rfkId: z.ZodString;
+        keyphrase: z.ZodOptional<z.ZodString>;
+        entity: z.ZodOptional<z.ZodString>;
+        page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        locale: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            language?: string | undefined;
+            country?: string | undefined;
+        }, {
+            language?: string | undefined;
+            country?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        domainId: string;
+        rfkId: string;
+        page: number;
+        limit: number;
+        entity?: string | undefined;
+        keyphrase?: string | undefined;
+        locale?: {
+            language?: string | undefined;
+            country?: string | undefined;
+        } | undefined;
+    }, {
+        domainId: string;
+        rfkId: string;
+        entity?: string | undefined;
+        keyphrase?: string | undefined;
+        page?: number | undefined;
+        limit?: number | undefined;
+        locale?: {
+            language?: string | undefined;
+            country?: string | undefined;
+        } | undefined;
+    }>;
+};
+//# sourceMappingURL=basic-search.d.ts.map

package/dist/tools/search/basic-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-search.d.ts","sourceRoot":"","sources":["../../../src/tools/search/basic-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAG5E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,mEAwBf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI3B,CAAC"}

package/dist/tools/search/basic-search.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { validateInput } from '../../utils/errors.js';
+/**
+ * Schema for basic search query
+ */
+export const BasicSearchSchema = z.object({
+    domainId: z.string().describe('Sitecore domain ID'),
+    rfkId: z.string().describe('RFK widget ID'),
+    keyphrase: z.string().optional().describe('Search query text'),
+    entity: z.string().optional().describe('Entity type to search (e.g., content, product)'),
+    page: z.number().optional().default(1).describe('Page number for pagination'),
+    limit: z.number().optional().default(24).describe('Number of results per page'),
+    locale: z.object({
+        language: z.string().optional(),
+        country: z.string().optional(),
+    }).optional().describe('Locale settings for the search'),
+});
+/**
+ * Execute a basic search query
+ */
+export async function executeBasicSearch(client, input) {
+    const params = validateInput(BasicSearchSchema, input);
+    const request = {
+        widget: {
+            items: [
+                {
+                    rfk_id: params.rfkId,
+                    entity: params.entity,
+                    search: {
+                        query: params.keyphrase ? { keyphrase: params.keyphrase } : undefined,
+                        offset: ((params.page || 1) - 1) * (params.limit || 24),
+                        limit: params.limit || 24,
+                    },
+                },
+            ],
+        },
+        context: params.locale ? {
+            locale: params.locale,
+        } : undefined,
+    };
+    return client.search(params.domainId, request);
+}
+/**
+ * MCP Tool Definition for basic search
+ */
+export const basicSearchTool = {
+    name: 'sitecore_search_query',
+    description: 'Execute a search query against Sitecore Search API. Returns search results with content items matching the query.',
+    inputSchema: BasicSearchSchema,
+};
+//# sourceMappingURL=basic-search.js.map

package/dist/tools/search/basic-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-search.js","sourceRoot":"","sources":["../../../src/tools/search/basic-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACxF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC/E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACzD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE;YACN,KAAK,EAAE;gBACL;oBACE,MAAM,EAAE,MAAM,CAAC,KAAK;oBACpB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE;wBACN,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;wBACrE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;wBACvD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;qBAC1B;iBACF;aACF;SACF;QACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,mHAAmH;IAChI,WAAW,EAAE,iBAAiB;CAC/B,CAAC"}

package/dist/tools/search/faceted-search.d.ts

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import { SearchClient } from '../../client/search-client.js';
+/**
+ * Schema for faceted search with filtering
+ */
+export declare const FacetedSearchSchema: z.ZodObject<{
+    domainId: z.ZodString;
+    rfkId: z.ZodString;
+    keyphrase: z.ZodOptional<z.ZodString>;
+    entity: z.ZodOptional<z.ZodString>;
+    facets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<["value", "range", "hierarchy"]>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        values?: string[] | undefined;
+        type?: "value" | "range" | "hierarchy" | undefined;
+    }, {
+        name: string;
+        values?: string[] | undefined;
+        type?: "value" | "range" | "hierarchy" | undefined;
+    }>, "many">>;
+    sort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["asc", "desc"]>>>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    domainId: string;
+    rfkId: string;
+    page: number;
+    limit: number;
+    sort?: Record<string, "asc" | "desc"> | undefined;
+    entity?: string | undefined;
+    keyphrase?: string | undefined;
+    facets?: {
+        name: string;
+        values?: string[] | undefined;
+        type?: "value" | "range" | "hierarchy" | undefined;
+    }[] | undefined;
+}, {
+    domainId: string;
+    rfkId: string;
+    sort?: Record<string, "asc" | "desc"> | undefined;
+    entity?: string | undefined;
+    keyphrase?: string | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    facets?: {
+        name: string;
+        values?: string[] | undefined;
+        type?: "value" | "range" | "hierarchy" | undefined;
+    }[] | undefined;
+}>;
+export type FacetedSearchInput = z.infer<typeof FacetedSearchSchema>;
+/**
+ * Execute a faceted search query with filters
+ */
+export declare function executeFacetedSearch(client: SearchClient, input: unknown): Promise<import("../../client/search-client.js").SearchResponse>;
+/**
+ * MCP Tool Definition for faceted search
+ */
+export declare const facetedSearchTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        domainId: z.ZodString;
+        rfkId: z.ZodString;
+        keyphrase: z.ZodOptional<z.ZodString>;
+        entity: z.ZodOptional<z.ZodString>;
+        facets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<["value", "range", "hierarchy"]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            values?: string[] | undefined;
+            type?: "value" | "range" | "hierarchy" | undefined;
+        }, {
+            name: string;
+            values?: string[] | undefined;
+            type?: "value" | "range" | "hierarchy" | undefined;
+        }>, "many">>;
+        sort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["asc", "desc"]>>>;
+        page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        domainId: string;
+        rfkId: string;
+        page: number;
+        limit: number;
+        sort?: Record<string, "asc" | "desc"> | undefined;
+        entity?: string | undefined;
+        keyphrase?: string | undefined;
+        facets?: {
+            name: string;
+            values?: string[] | undefined;
+            type?: "value" | "range" | "hierarchy" | undefined;
+        }[] | undefined;
+    }, {
+        domainId: string;
+        rfkId: string;
+        sort?: Record<string, "asc" | "desc"> | undefined;
+        entity?: string | undefined;
+        keyphrase?: string | undefined;
+        page?: number | undefined;
+        limit?: number | undefined;
+        facets?: {
+            name: string;
+            values?: string[] | undefined;
+            type?: "value" | "range" | "hierarchy" | undefined;
+        }[] | undefined;
+    }>;
+};
+//# sourceMappingURL=faceted-search.d.ts.map

package/dist/tools/search/faceted-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceted-search.d.ts","sourceRoot":"","sources":["../../../src/tools/search/faceted-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAG5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,mEAuBf;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI7B,CAAC"}

package/dist/tools/search/faceted-search.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { validateInput } from '../../utils/errors.js';
+/**
+ * Schema for faceted search with filtering
+ */
+export const FacetedSearchSchema = z.object({
+    domainId: z.string().describe('Sitecore domain ID'),
+    rfkId: z.string().describe('RFK widget ID'),
+    keyphrase: z.string().optional().describe('Search query text'),
+    entity: z.string().optional().describe('Entity type to search'),
+    facets: z.array(z.object({
+        name: z.string().describe('Facet field name'),
+        type: z.enum(['value', 'range', 'hierarchy']).optional().describe('Facet type'),
+        values: z.array(z.string()).optional().describe('Selected facet values for filtering'),
+    })).optional().describe('Facet configuration and filters'),
+    sort: z.record(z.enum(['asc', 'desc'])).optional().describe('Sort criteria'),
+    page: z.number().optional().default(1),
+    limit: z.number().optional().default(24),
+});
+/**
+ * Execute a faceted search query with filters
+ */
+export async function executeFacetedSearch(client, input) {
+    const params = validateInput(FacetedSearchSchema, input);
+    const request = {
+        widget: {
+            items: [
+                {
+                    rfk_id: params.rfkId,
+                    entity: params.entity,
+                    search: {
+                        query: params.keyphrase ? { keyphrase: params.keyphrase } : undefined,
+                        facet: params.facets,
+                        sort: params.sort,
+                        offset: ((params.page || 1) - 1) * (params.limit || 24),
+                        limit: params.limit || 24,
+                    },
+                },
+            ],
+        },
+    };
+    return client.search(params.domainId, request);
+}
+/**
+ * MCP Tool Definition for faceted search
+ */
+export const facetedSearchTool = {
+    name: 'sitecore_search_with_facets',
+    description: 'Execute a faceted search query with filtering and sorting. Returns search results with facet aggregations for filtering UI.',
+    inputSchema: FacetedSearchSchema,
+};
+//# sourceMappingURL=faceted-search.js.map

package/dist/tools/search/faceted-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceted-search.js","sourceRoot":"","sources":["../../../src/tools/search/faceted-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC/D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC/E,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACvF,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE;YACN,KAAK,EAAE;gBACL;oBACE,MAAM,EAAE,MAAM,CAAC,KAAK;oBACpB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE;wBACN,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;wBACrE,KAAK,EAAE,MAAM,CAAC,MAAM;wBACpB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;wBACvD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;qBAC1B;iBACF;aACF;SACF;KACF,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,6HAA6H;IAC1I,WAAW,EAAE,mBAAmB;CACjC,CAAC"}

package/dist/tools/search/recommendations.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { SearchClient } from '../../client/search-client.js';
+/**
+ * Schema for recommendations
+ */
+export declare const RecommendationsSchema: z.ZodObject<{
+    domainId: z.ZodString;
+    rfkId: z.ZodString;
+    recommendationId: z.ZodOptional<z.ZodString>;
+    entity: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    domainId: string;
+    rfkId: string;
+    limit: number;
+    entity?: string | undefined;
+    recommendationId?: string | undefined;
+    userId?: string | undefined;
+}, {
+    domainId: string;
+    rfkId: string;
+    entity?: string | undefined;
+    limit?: number | undefined;
+    recommendationId?: string | undefined;
+    userId?: string | undefined;
+}>;
+export type RecommendationsInput = z.infer<typeof RecommendationsSchema>;
+/**
+ * Get personalized recommendations
+ */
+export declare function getRecommendations(client: SearchClient, input: unknown): Promise<import("../../client/search-client.js").SearchResponse>;
+/**
+ * MCP Tool Definition for recommendations
+ */
+export declare const recommendationsTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        domainId: z.ZodString;
+        rfkId: z.ZodString;
+        recommendationId: z.ZodOptional<z.ZodString>;
+        entity: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        domainId: string;
+        rfkId: string;
+        limit: number;
+        entity?: string | undefined;
+        recommendationId?: string | undefined;
+        userId?: string | undefined;
+    }, {
+        domainId: string;
+        rfkId: string;
+        entity?: string | undefined;
+        limit?: number | undefined;
+        recommendationId?: string | undefined;
+        userId?: string | undefined;
+    }>;
+};
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/tools/search/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/tools/search/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAG5E;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,mEA2Bf;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;CAI/B,CAAC"}

package/dist/tools/search/recommendations.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { validateInput } from '../../utils/errors.js';
+/**
+ * Schema for recommendations
+ */
+export const RecommendationsSchema = z.object({
+    domainId: z.string().describe('Sitecore domain ID'),
+    rfkId: z.string().describe('RFK widget ID'),
+    recommendationId: z.string().optional().describe('Recipe-based recommendation ID'),
+    entity: z.string().optional().describe('Entity type'),
+    userId: z.string().optional().describe('User UUID for personalized recommendations'),
+    limit: z.number().optional().default(10).describe('Number of recommendations'),
+});
+/**
+ * Get personalized recommendations
+ */
+export async function getRecommendations(client, input) {
+    const params = validateInput(RecommendationsSchema, input);
+    const request = {
+        widget: {
+            items: [
+                {
+                    rfk_id: params.rfkId,
+                    entity: params.entity,
+                    recommendation: {
+                        id: params.recommendationId,
+                    },
+                    search: {
+                        limit: params.limit,
+                    },
+                },
+            ],
+        },
+        context: params.userId ? {
+            user: {
+                uuid: params.userId,
+            },
+        } : undefined,
+    };
+    return client.search(params.domainId, request);
+}
+/**
+ * MCP Tool Definition for recommendations
+ */
+export const recommendationsTool = {
+    name: 'sitecore_get_recommendations',
+    description: 'Get personalized content or product recommendations based on user behavior and configured recipes.',
+    inputSchema: RecommendationsSchema,
+};
+//# sourceMappingURL=recommendations.js.map

package/dist/tools/search/recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../../src/tools/search/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC3C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAClF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAC/E,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE;YACN,KAAK,EAAE;gBACL;oBACE,MAAM,EAAE,MAAM,CAAC,KAAK;oBACpB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,cAAc,EAAE;wBACd,EAAE,EAAE,MAAM,CAAC,gBAAgB;qBAC5B;oBACD,MAAM,EAAE;wBACN,KAAK,EAAE,MAAM,CAAC,KAAK;qBACpB;iBACF;aACF;SACF;QACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACvB,IAAI,EAAE;gBACJ,IAAI,EAAE,MAAM,CAAC,MAAM;aACpB;SACF,CAAC,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,oGAAoG;IACjH,WAAW,EAAE,qBAAqB;CACnC,CAAC"}