@cesteral/linkedin-mcp 1.0.0

package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListAdAccountsInputSchema: z.ZodObject<{
+    start: z.ZodOptional<z.ZodNumber>;
+    count: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    start?: number | undefined;
+    count?: number | undefined;
+}, {
+    start?: number | undefined;
+    count?: number | undefined;
+}>;
+export declare const ListAdAccountsOutputSchema: z.ZodObject<{
+    accounts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+        pageSize: z.ZodNumber;
+        totalCount: z.ZodOptional<z.ZodNumber>;
+        nextPageInputKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    accounts: Record<string, any>[];
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    timestamp: string;
+}, {
+    accounts: Record<string, any>[];
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    timestamp: string;
+}>;
+type ListAdAccountsInput = z.infer<typeof ListAdAccountsInputSchema>;
+type ListAdAccountsOutput = z.infer<typeof ListAdAccountsOutputSchema>;
+export declare function listAdAccountsLogic(input: ListAdAccountsInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListAdAccountsOutput>;
+export declare function listAdAccountsResponseFormatter(result: ListAdAccountsOutput): McpTextContent[];
+export declare const listAdAccountsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        start: z.ZodOptional<z.ZodNumber>;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        start?: number | undefined;
+        count?: number | undefined;
+    }, {
+        start?: number | undefined;
+        count?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        accounts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        pagination: z.ZodObject<{
+            nextCursor: z.ZodNullable<z.ZodString>;
+            hasMore: z.ZodBoolean;
+            pageSize: z.ZodNumber;
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextPageInputKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        accounts: Record<string, any>[];
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        timestamp: string;
+    }, {
+        accounts: Record<string, any>[];
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        timestamp: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            start?: undefined;
+            count?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            start: number;
+            count: number;
+        };
+    })[];
+    logic: typeof listAdAccountsLogic;
+    responseFormatter: typeof listAdAccountsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-ad-accounts.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-ad-accounts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-ad-accounts.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,eAAO,MAAM,yBAAyB;;;;;;;;;EAWoB,CAAC;AAE3D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMD,CAAC;AAEvC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAuB/B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAS9F;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB9B,CAAC"}

package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_list_ad_accounts";
+const TOOL_TITLE = "List LinkedIn Ad Accounts";
+const TOOL_DESCRIPTION = `List LinkedIn Ads accounts accessible to the authenticated user.
+
+Returns ad accounts with their URNs, names, status, and currency.
+Use the returned URNs as \`adAccountUrn\` in other tools.`;
+export const ListAdAccountsInputSchema = z
+    .object({
+    start: z.number().int().min(0).optional().describe("Offset for pagination (default 0)"),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Number of accounts per page (default 25, max 100)"),
+})
+    .describe("Parameters for listing LinkedIn ad accounts");
+export const ListAdAccountsOutputSchema = z
+    .object({
+    accounts: z.array(z.record(z.any())).describe("List of ad accounts"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("Ad accounts list result");
+export async function listAdAccountsLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const result = await linkedInService.listAdAccounts(input.start, input.count, context);
+    const total = result.total;
+    const currentStart = input.start ?? 0;
+    const pageSize = result.accounts.length;
+    const requestedCount = input.count ?? 25;
+    const hasMore = total !== undefined ? currentStart + pageSize < total : pageSize >= requestedCount;
+    const nextStart = currentStart + pageSize;
+    return {
+        accounts: result.accounts,
+        pagination: buildPaginationOutput({
+            nextCursor: hasMore ? String(nextStart) : null,
+            pageSize,
+            totalCount: total,
+            nextPageInputKey: "start",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listAdAccountsResponseFormatter(result) {
+    const { pageSize, totalCount } = result.pagination;
+    const totalInfo = totalCount !== undefined ? ` (total: ${totalCount})` : "";
+    return [
+        {
+            type: "text",
+            text: `Found ${pageSize} ad accounts${totalInfo}\n\n${JSON.stringify(result.accounts, null, 2)}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listAdAccountsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListAdAccountsInputSchema,
+    outputSchema: ListAdAccountsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "List first 25 ad accounts",
+            input: {},
+        },
+        {
+            label: "List next page",
+            input: { start: 25, count: 25 },
+        },
+    ],
+    logic: listAdAccountsLogic,
+    responseFormatter: listAdAccountsResponseFormatter,
+};
+//# sourceMappingURL=list-ad-accounts.tool.js.map

package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-ad-accounts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-ad-accounts.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts

@@ -0,0 +1,165 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListEntitiesInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    adAccountUrn: z.ZodOptional<z.ZodString>;
+    start: z.ZodOptional<z.ZodNumber>;
+    count: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    start?: number | undefined;
+    count?: number | undefined;
+    adAccountUrn?: string | undefined;
+}, {
+    entityType: string;
+    start?: number | undefined;
+    count?: number | undefined;
+    adAccountUrn?: string | undefined;
+}>;
+export declare const ListEntitiesOutputSchema: z.ZodObject<{
+    entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+        pageSize: z.ZodNumber;
+        totalCount: z.ZodOptional<z.ZodNumber>;
+        nextPageInputKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entities: Record<string, any>[];
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    timestamp: string;
+}, {
+    entities: Record<string, any>[];
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+    timestamp: string;
+}>;
+type ListEntitiesInput = z.infer<typeof ListEntitiesInputSchema>;
+type ListEntitiesOutput = z.infer<typeof ListEntitiesOutputSchema>;
+export declare function listEntitiesLogic(input: ListEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListEntitiesOutput>;
+export declare function listEntitiesResponseFormatter(result: ListEntitiesOutput): McpTextContent[];
+export declare const listEntitiesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        adAccountUrn: z.ZodOptional<z.ZodString>;
+        start: z.ZodOptional<z.ZodNumber>;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        start?: number | undefined;
+        count?: number | undefined;
+        adAccountUrn?: string | undefined;
+    }, {
+        entityType: string;
+        start?: number | undefined;
+        count?: number | undefined;
+        adAccountUrn?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        pagination: z.ZodObject<{
+            nextCursor: z.ZodNullable<z.ZodString>;
+            hasMore: z.ZodBoolean;
+            pageSize: z.ZodNumber;
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextPageInputKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entities: Record<string, any>[];
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        timestamp: string;
+    }, {
+        entities: Record<string, any>[];
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+        timestamp: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            adAccountUrn: string;
+            count: number;
+            start?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            adAccountUrn: string;
+            count?: undefined;
+            start?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            adAccountUrn: string;
+            start: number;
+            count: number;
+        };
+    })[];
+    logic: typeof listEntitiesLogic;
+    responseFormatter: typeof listEntitiesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-entities.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAgBuB,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMJ,CAAC;AAElC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAe1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC"}

package/dist/mcp-server/tools/definitions/list-entities.tool.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum, isAccountScopedEntity, } from "../utils/entity-mapping.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_list_entities";
+const TOOL_TITLE = "List LinkedIn Ads Entities";
+const TOOL_DESCRIPTION = `List LinkedIn Ads entities with offset-based pagination. Most entity types require \`adAccountUrn\` for scoping. All LinkedIn IDs are URNs (e.g., \`urn:li:sponsoredAccount:123\`). Use \`start\` offset for subsequent pages.`;
+export const ListEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to list"),
+    adAccountUrn: z
+        .string()
+        .optional()
+        .describe("Ad Account URN (required for campaignGroup, campaign, creative, conversionRule)"),
+    start: z.number().int().min(0).optional().describe("Offset for pagination (default 0)"),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Number of entities per page (default 25, max 100)"),
+})
+    .describe("Parameters for listing LinkedIn Ads entities");
+export const ListEntitiesOutputSchema = z
+    .object({
+    entities: z.array(z.record(z.any())).describe("List of entities"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity list result");
+export async function listEntitiesLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    if (isAccountScopedEntity(input.entityType) && !input.adAccountUrn) {
+        throw new McpError(JsonRpcErrorCode.InvalidParams, `adAccountUrn is required for entityType "${input.entityType}". ` +
+            "Use linkedin_list_ad_accounts to find available accounts.");
+    }
+    const result = await linkedInService.listEntities(input.entityType, input.adAccountUrn, input.start, input.count, context);
+    const pageSize = result.entities.length;
+    const total = result.total;
+    const currentStart = result.start ?? 0;
+    const requestedCount = input.count ?? 25;
+    const hasMore = total !== undefined ? currentStart + pageSize < total : pageSize >= requestedCount;
+    const nextStart = currentStart + pageSize;
+    return {
+        entities: result.entities,
+        pagination: buildPaginationOutput({
+            nextCursor: hasMore ? String(nextStart) : null,
+            pageSize,
+            totalCount: total,
+            nextPageInputKey: "start",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listEntitiesResponseFormatter(result) {
+    const { pageSize, totalCount } = result.pagination;
+    const totalInfo = totalCount !== undefined ? ` (total: ${totalCount})` : "";
+    const summary = `Found ${pageSize} entities${totalInfo}`;
+    const entities = pageSize > 0
+        ? `\n\nEntities:\n${JSON.stringify(result.entities, null, 2)}`
+        : "\n\nNo entities found";
+    return [
+        {
+            type: "text",
+            text: `${summary}${entities}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListEntitiesInputSchema,
+    outputSchema: ListEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "List active campaigns for an ad account",
+            input: {
+                entityType: "campaign",
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                count: 25,
+            },
+        },
+        {
+            label: "List all campaign groups",
+            input: {
+                entityType: "campaignGroup",
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+            },
+        },
+        {
+            label: "Paginate through creatives (second page)",
+            input: {
+                entityType: "creative",
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                start: 25,
+                count: 25,
+            },
+        },
+    ],
+    logic: listEntitiesLogic,
+    responseFormatter: listEntitiesResponseFormatter,
+};
+//# sourceMappingURL=list-entities.tool.js.map

package/dist/mcp-server/tools/definitions/list-entities.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const SearchTargetingInputSchema: z.ZodObject<{
+    facetType: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    facetType: string;
+    query?: string | undefined;
+    limit?: number | undefined;
+}, {
+    facetType: string;
+    query?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare const SearchTargetingOutputSchema: z.ZodObject<{
+    facetType: z.ZodString;
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    count: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    results: Record<string, any>[];
+    facetType: string;
+    timestamp: string;
+}, {
+    count: number;
+    results: Record<string, any>[];
+    facetType: string;
+    timestamp: string;
+}>;
+type SearchTargetingInput = z.infer<typeof SearchTargetingInputSchema>;
+type SearchTargetingOutput = z.infer<typeof SearchTargetingOutputSchema>;
+export declare function searchTargetingLogic(input: SearchTargetingInput, context: RequestContext, sdkContext?: SdkContext): Promise<SearchTargetingOutput>;
+export declare function searchTargetingResponseFormatter(result: SearchTargetingOutput): McpTextContent[];
+export declare const searchTargetingTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        facetType: z.ZodString;
+        query: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        facetType: string;
+        query?: string | undefined;
+        limit?: number | undefined;
+    }, {
+        facetType: string;
+        query?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        facetType: z.ZodString;
+        results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        count: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        results: Record<string, any>[];
+        facetType: string;
+        timestamp: string;
+    }, {
+        count: number;
+        results: Record<string, any>[];
+        facetType: string;
+        timestamp: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            facetType: string;
+            query: string;
+            limit: number;
+        };
+    } | {
+        label: string;
+        input: {
+            facetType: string;
+            query: string;
+            limit?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            facetType: string;
+            limit: number;
+            query?: undefined;
+        };
+    })[];
+    logic: typeof searchTargetingLogic;
+    responseFormatter: typeof searchTargetingResponseFormatter;
+};
+export {};
+//# sourceMappingURL=search-targeting.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-targeting.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmBnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAY0B,CAAC;AAElE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAOF,CAAC;AAEvC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAkBhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAOhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC/B,CAAC"}