@cesteral/dbm-mcp 1.0.0

package/dist/mcp-server/prompts/definitions/troubleshoot-report.prompt.js

@@ -0,0 +1,179 @@
+export const troubleshootReportPrompt = {
+    name: "troubleshoot_report",
+    description: "Diagnostic workflow for debugging failed Bid Manager queries and common issues",
+    arguments: [
+        {
+            name: "errorMessage",
+            description: "The error message from the failed query",
+            required: false,
+        },
+        {
+            name: "queryType",
+            description: "Type of query that failed (e.g., 'dbm_run_custom_query', 'dbm_get_campaign_delivery')",
+            required: false,
+        },
+    ],
+};
+export function getTroubleshootReportMessage(args) {
+    const errorMessage = args?.errorMessage || "{error message}";
+    const queryType = args?.queryType || "dbm_run_custom_query";
+    return `# Troubleshooting Bid Manager Report Issues
+
+## Error Context
+- **Tool:** ${queryType}
+- **Error:** ${errorMessage}
+
+---
+
+## Step 1: Identify Error Category
+
+### Validation Errors
+If you see "Unknown filter type" or "Unknown metric type":
+
+1. **Check spelling** - Filter/metric names are case-sensitive and exact
+2. **Verify availability** - Some filters/metrics only work with specific report types
+3. **Fetch references:**
+   - \`filter-types://all\` - All valid filter names
+   - \`metric-types://all\` - All valid metric names
+   - \`report-types://all\` - Report type compatibility
+
+**Quick fix:** Set \`strictValidation: false\` to bypass validation and see API's native error
+
+---
+
+### API Errors
+If you see "Report failed" or "Query execution failed":
+
+1. **Check date range:**
+   - Is the date range valid? (start before end)
+   - Is data available for that period?
+   - Try a recent preset like \`LAST_7_DAYS\`
+
+2. **Check advertiser ID:**
+   - Is the advertiser ID correct?
+   - Do you have access to this advertiser?
+
+3. **Reduce complexity:**
+   - Fewer groupBys = smaller report
+   - Start with 2-3 groupBys max
+   - Some combinations aren't supported
+
+---
+
+### No Data Returned
+If the query succeeds but returns empty results:
+
+1. **Verify filters:**
+   - Is the advertiser ID correct?
+   - Are campaign/line item IDs valid?
+   - Check if filters are too restrictive
+
+2. **Check date range:**
+   - Is there activity in this period?
+   - Try \`LAST_30_DAYS\` for broader range
+
+3. **Verify metric availability:**
+   - Video metrics require video campaigns
+   - Conversion metrics require Floodlight setup
+   - Reach metrics require REACH report type
+
+---
+
+## Step 2: Common Issues by Report Type
+
+### STANDARD Reports
+- Most flexible, supports most filters/metrics
+- Conversion metrics may need Floodlight setup
+
+### YOUTUBE Reports
+- Requires YouTube/TrueView campaigns
+- Only supports YouTube-specific metrics
+- Limited filter compatibility
+
+### FLOODLIGHT Reports
+- Requires Floodlight activities
+- Uses \`FILTER_FLOODLIGHT_ACTIVITY\` for grouping
+- Limited to conversion-related metrics
+
+### REACH Reports
+- Limited to reach/frequency metrics
+- Fewer groupBy options supported
+- May have data processing delays
+
+---
+
+## Step 3: Diagnostic Queries
+
+### Test Basic Connectivity
+\`\`\`json
+{
+  "reportType": "STANDARD",
+  "groupBys": ["FILTER_DATE"],
+  "metrics": ["METRIC_IMPRESSIONS"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "{advertiserId}" }
+  ],
+  "dateRange": { "preset": "LAST_7_DAYS" }
+}
+\`\`\`
+
+### Test Specific Campaign
+\`\`\`json
+{
+  "reportType": "STANDARD",
+  "groupBys": ["FILTER_MEDIA_PLAN"],
+  "metrics": ["METRIC_IMPRESSIONS", "METRIC_CLICKS"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "{advertiserId}" },
+    { "type": "FILTER_MEDIA_PLAN", "value": "{campaignId}" }
+  ],
+  "dateRange": { "preset": "LAST_30_DAYS" }
+}
+\`\`\`
+
+---
+
+## Step 4: Error Messages Reference
+
+| Error | Cause | Solution |
+|-------|-------|----------|
+| "Unknown filter type: X" | Invalid filter name | Check \`filter-types://all\` |
+| "Unknown metric type: X" | Invalid metric name | Check \`metric-types://all\` |
+| "Unknown report type: X" | Invalid report type | Use STANDARD, YOUTUBE, etc. |
+| "Unknown date range preset" | Invalid preset | Check \`report-types://all\` |
+| "Report timed out" | Query too large | Reduce groupBys or date range |
+| "No data available" | Empty results | Check filters, widen date range |
+| "Access denied" | Permission issue | Verify advertiser access |
+| "Invalid date range" | Date format error | Use YYYY-MM-DD format |
+
+---
+
+## Step 5: Escalation
+
+If issues persist after troubleshooting:
+
+1. **Try pass-through mode:**
+   \`\`\`json
+   { "strictValidation": false }
+   \`\`\`
+   This sends the query directly to the API for native error messages.
+
+2. **Check API status:**
+   - Bid Manager API may have service issues
+   - Check Google Cloud Status Dashboard
+
+3. **Verify credentials:**
+   - OAuth tokens may need refresh
+   - Service account permissions may be insufficient
+
+---
+
+## Best Practices
+
+1. **Start simple** - Begin with few groupBys and expand
+2. **Use presets** - Date presets are more reliable than custom dates
+3. **Filter early** - Add specific filters to reduce data volume
+4. **Check examples** - Fetch \`query-examples://all\` for working templates
+`;
+}
+//# sourceMappingURL=troubleshoot-report.prompt.js.map

package/dist/mcp-server/prompts/definitions/troubleshoot-report.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshoot-report.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/troubleshoot-report.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,wBAAwB,GAAW;IAC9C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,gFAAgF;IAC7F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,uFAAuF;YACzF,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,IAA6B;IACxE,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,iBAAiB,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,sBAAsB,CAAC;IAE5D,OAAO;;;cAGK,SAAS;eACR,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJ1B,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/types.d.ts

@@ -0,0 +1,15 @@
+export interface PromptArgument {
+    name: string;
+    description: string;
+    required?: boolean;
+}
+export interface Prompt {
+    name: string;
+    description: string;
+    arguments?: PromptArgument[];
+}
+export interface PromptDefinition {
+    prompt: Prompt;
+    generateMessage: (args?: Record<string, string>) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp-server/prompts/definitions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAKD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAC5D"}

package/dist/mcp-server/prompts/definitions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp-server/prompts/definitions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/types.ts"],"names":[],"mappings":""}

package/dist/mcp-server/prompts/index.d.ts

@@ -0,0 +1,6 @@
+export type { Prompt, PromptArgument, PromptDefinition } from "./definitions/types.js";
+import type { PromptDefinition } from "./definitions/types.js";
+export declare const promptRegistry: Map<string, PromptDefinition>;
+export declare function getAllPrompts(): import("./index.js").Prompt[];
+export declare function getPromptDefinition(name: string): PromptDefinition | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AA0BvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK/D,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CA2CvD,CAAC;AAKH,wBAAgB,aAAa,kCAE5B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9E"}

package/dist/mcp-server/prompts/index.js

@@ -0,0 +1,57 @@
+import { customQueryWorkflowPrompt, getCustomQueryWorkflowMessage, } from "./definitions/custom-query-workflow.prompt.js";
+import { troubleshootReportPrompt, getTroubleshootReportMessage, } from "./definitions/troubleshoot-report.prompt.js";
+import { toolSchemaExplorationPrompt, getToolSchemaExplorationMessage, } from "./definitions/tool-schema-exploration.prompt.js";
+import { pacingPerformanceAnalysisPrompt, getPacingPerformanceAnalysisMessage, } from "./definitions/pacing-performance-analysis.prompt.js";
+import { crossPlatformPerformancePrompt, getCrossPlatformPerformanceMessage, } from "./definitions/cross-platform-performance.prompt.js";
+import { crossPlatformCampaignSetupPrompt, getCrossPlatformCampaignSetupMessage, } from "./definitions/cross-platform-campaign-setup.prompt.js";
+export const promptRegistry = new Map([
+    [
+        customQueryWorkflowPrompt.name,
+        {
+            prompt: customQueryWorkflowPrompt,
+            generateMessage: getCustomQueryWorkflowMessage,
+        },
+    ],
+    [
+        troubleshootReportPrompt.name,
+        {
+            prompt: troubleshootReportPrompt,
+            generateMessage: getTroubleshootReportMessage,
+        },
+    ],
+    [
+        toolSchemaExplorationPrompt.name,
+        {
+            prompt: toolSchemaExplorationPrompt,
+            generateMessage: getToolSchemaExplorationMessage,
+        },
+    ],
+    [
+        pacingPerformanceAnalysisPrompt.name,
+        {
+            prompt: pacingPerformanceAnalysisPrompt,
+            generateMessage: getPacingPerformanceAnalysisMessage,
+        },
+    ],
+    [
+        crossPlatformPerformancePrompt.name,
+        {
+            prompt: crossPlatformPerformancePrompt,
+            generateMessage: getCrossPlatformPerformanceMessage,
+        },
+    ],
+    [
+        crossPlatformCampaignSetupPrompt.name,
+        {
+            prompt: crossPlatformCampaignSetupPrompt,
+            generateMessage: getCrossPlatformCampaignSetupMessage,
+        },
+    ],
+]);
+export function getAllPrompts() {
+    return Array.from(promptRegistry.values()).map((def) => def.prompt);
+}
+export function getPromptDefinition(name) {
+    return promptRegistry.get(name);
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,uDAAuD,CAAC;AAM/D,MAAM,CAAC,MAAM,cAAc,GAAkC,IAAI,GAAG,CAAC;IACnE;QACE,yBAAyB,CAAC,IAAI;QAC9B;YACE,MAAM,EAAE,yBAAyB;YACjC,eAAe,EAAE,6BAA6B;SAC/C;KACF;IACD;QACE,wBAAwB,CAAC,IAAI;QAC7B;YACE,MAAM,EAAE,wBAAwB;YAChC,eAAe,EAAE,4BAA4B;SAC9C;KACF;IACD;QACE,2BAA2B,CAAC,IAAI;QAChC;YACE,MAAM,EAAE,2BAA2B;YACnC,eAAe,EAAE,+BAA+B;SACjD;KACF;IACD;QACE,+BAA+B,CAAC,IAAI;QACpC;YACE,MAAM,EAAE,+BAA+B;YACvC,eAAe,EAAE,mCAAmC;SACrD;KACF;IACD;QACE,8BAA8B,CAAC,IAAI;QACnC;YACE,MAAM,EAAE,8BAA8B;YACtC,eAAe,EAAE,kCAAkC;SACpD;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;CACF,CAAC,CAAC;AAKH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/mcp-server/resources/definitions/compatibility-rules.resource.d.ts

@@ -0,0 +1,3 @@
+import type { Resource } from "../types.js";
+export declare const compatibilityRulesResource: Resource;
+//# sourceMappingURL=compatibility-rules.resource.d.ts.map

package/dist/mcp-server/resources/definitions/compatibility-rules.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-rules.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/compatibility-rules.resource.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA0I5C,eAAO,MAAM,0BAA0B,EAAE,QAMxC,CAAC"}

package/dist/mcp-server/resources/definitions/compatibility-rules.resource.js

@@ -0,0 +1,130 @@
+import { REPORT_TYPE_RESTRICTIONS, INCOMPATIBLE_COMBINATIONS, GROUP_BY_ONLY_FILTERS, BEST_PRACTICES, } from "../../../generated/index.js";
+function formatCompatibilityRulesMarkdown() {
+    return `# Bid Manager API Compatibility Rules
+
+This resource documents known restrictions and requirements for using metrics and filters together in different report types.
+
+**Important:** The Bid Manager API performs its own validation and will return HTTP 400 for invalid combinations. These rules are based on naming conventions and Google's documentation to help you avoid errors.
+
+---
+
+## Report Type Restrictions
+
+The following metrics and filters are EXCLUSIVE to specific report types:
+
+| Pattern | Required Report Type(s) | Description |
+|---------|------------------------|-------------|
+${REPORT_TYPE_RESTRICTIONS.filter((r) => r.exclusive)
+        .map((rule) => {
+        const pattern = rule.metricsPattern?.source || rule.filtersPattern?.source || "N/A";
+        return `| \`${pattern}\` | ${rule.reportTypes.join(", ")} | ${rule.description} |`;
+    })
+        .join("\n")}
+
+### Key Rules
+
+1. **TrueView Metrics/Filters** (\`METRIC_TRUEVIEW*\`, \`FILTER_TRUEVIEW*\`)
+   - Only available in \`reportType: "YOUTUBE"\`
+   - Using these with STANDARD will cause an API error
+
+2. **Unique Reach Metrics** (\`METRIC_UNIQUE_REACH*\`)
+   - Only available in \`reportType: "REACH"\` or \`"UNIQUE_REACH_AUDIENCE"\`
+   - These metrics have privacy thresholds and may return incomplete data with granular dimensions
+
+3. **GRP Metrics/Filters** (\`METRIC_GRP*\`, \`FILTER_NIELSEN*\`)
+   - Only available in \`reportType: "GRP"\`
+
+4. **YouTube Programmatic Guaranteed** (\`*YOUTUBE_PROGRAMMATIC_GUARANTEED*\`)
+   - Only available in \`reportType: "YOUTUBE_PROGRAMMATIC_GUARANTEED"\`
+
+5. **Floodlight Metrics/Filters** (\`*FLOODLIGHT*\`)
+   - Available in both \`reportType: "STANDARD"\` and \`"FLOODLIGHT"\`
+
+---
+
+## GroupBy-Only Filters
+
+These filters can ONLY be used in the \`groupBys\` array, NOT in the \`filters\` array:
+
+${GROUP_BY_ONLY_FILTERS.map((f) => `- \`${f}\``).join("\n")}
+
+Using these as filters (instead of groupBys) will cause an API error.
+
+---
+
+## Known Incompatible Combinations
+
+${INCOMPATIBLE_COMBINATIONS.map((combo) => `### ${combo.description}
+
+${combo.incompatibleItems.metrics ? `**Affected metrics:**\n${combo.incompatibleItems.metrics.map((m) => `- \`${m}\``).join("\n")}` : ""}
+
+**Reason:** ${combo.reason}
+`).join("\n")}
+
+---
+
+## Best Practices
+
+${BEST_PRACTICES.map((bp, i) => `${i + 1}. ${bp}`).join("\n")}
+
+---
+
+## Validation Workflow
+
+When building a query, validate your configuration in this order:
+
+1. **Check Report Type Compatibility**
+   - Ensure all metrics match the selected report type
+   - Ensure all filters match the selected report type
+
+2. **Check Filter Usage**
+   - Time-based dimensions (DATE, WEEK, etc.) must be in \`groupBys\`, not \`filters\`
+   - Entity filters (ADVERTISER, CAMPAIGN) can be in either
+
+3. **Test in DV360 UI First**
+   - Build the report in the Display & Video 360 interface
+   - Use "Show incompatible" toggle to verify combinations
+   - Export the configuration once validated
+
+---
+
+## Example: Validating a Query
+
+\`\`\`json
+{
+  "reportType": "YOUTUBE",
+  "groupBys": ["FILTER_DATE", "FILTER_LINE_ITEM"],
+  "metrics": [
+    "METRIC_TRUEVIEW_VIEWS",       // ✓ YOUTUBE-specific
+    "METRIC_TRUEVIEW_VIEW_RATE",   // ✓ YOUTUBE-specific
+    "METRIC_IMPRESSIONS"           // ✓ General metric
+  ],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" }  // ✓ General filter
+  ]
+}
+\`\`\`
+
+This query is valid because:
+- TrueView metrics are used with YOUTUBE report type
+- FILTER_DATE is in groupBys (not filters)
+- General metrics/filters work with any report type
+
+---
+
+## Related Resources
+
+- \`metric-types://all\` - Complete metric reference with report type compatibility
+- \`filter-types://all\` - Complete filter reference with report type compatibility
+- \`report-types://all\` - Report type reference with compatible metrics/filters lists
+- \`query-examples://all\` - Example queries for common use cases
+`;
+}
+export const compatibilityRulesResource = {
+    uri: "compatibility-rules://all",
+    name: "Bid Manager Compatibility Rules",
+    description: "Detailed compatibility rules for metrics and filters across report types",
+    mimeType: "text/markdown",
+    getContent: () => formatCompatibilityRulesMarkdown(),
+};
+//# sourceMappingURL=compatibility-rules.resource.js.map

package/dist/mcp-server/resources/definitions/compatibility-rules.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-rules.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/compatibility-rules.resource.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAKrC,SAAS,gCAAgC;IACvC,OAAO;;;;;;;;;;;;;;EAcP,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;SAClD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,MAAM,IAAI,KAAK,CAAC;QACpF,OAAO,OAAO,OAAO,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC;IACrF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BX,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;EAQzD,yBAAyB,CAAC,GAAG,CAC7B,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,WAAW;;EAEnC,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;;cAE1H,KAAK,CAAC,MAAM;CACzB,CACA,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;EAMV,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqD5D,CAAC;AACF,CAAC;AAKD,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,2BAA2B;IAChC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC,gCAAgC,EAAE;CACrD,CAAC"}

package/dist/mcp-server/resources/definitions/filter-types.resource.d.ts

@@ -0,0 +1,4 @@
+import type { Resource } from "../types.js";
+export declare const filterTypesResource: Resource;
+export declare const filterTypeCategoryResources: Resource[];
+//# sourceMappingURL=filter-types.resource.d.ts.map

package/dist/mcp-server/resources/definitions/filter-types.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-types.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/filter-types.resource.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiO5C,eAAO,MAAM,mBAAmB,EAAE,QASjC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,EAM/C,CAAC"}

package/dist/mcp-server/resources/definitions/filter-types.resource.js

@@ -0,0 +1,198 @@
+import { FILTER_METADATA, FILTER_CATEGORIES, } from "../../../generated/index.js";
+let cachedFiltersMarkdown;
+const cachedCategoryMarkdown = new Map();
+function toCategorySlug(category) {
+    return category
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/(^-|-$)/g, "");
+}
+function formatFiltersMarkdown() {
+    const byCategory = new Map();
+    const byReportType = new Map();
+    for (const [filter, meta] of Object.entries(FILTER_METADATA)) {
+        const existing = byCategory.get(meta.category) || [];
+        existing.push([filter, meta]);
+        byCategory.set(meta.category, existing);
+        if (meta.reportTypes && meta.reportTypes.length < 3) {
+            for (const rt of meta.reportTypes) {
+                const rtExisting = byReportType.get(rt) || [];
+                rtExisting.push([filter, meta]);
+                byReportType.set(rt, rtExisting);
+            }
+        }
+    }
+    const totalFilters = Object.keys(FILTER_METADATA).length;
+    let markdown = `# Bid Manager API Filter/Dimension Types Reference
+
+This resource provides a complete reference of all ${totalFilters} available filter and dimension types for Bid Manager API queries.
+
+## Usage
+
+Filters are used in two ways:
+1. **In \`filters\` array**: To restrict data to specific values (e.g., filter by advertiser ID)
+2. **In \`groupBys\` array**: To break down data by dimension (e.g., daily breakdown)
+
+**Important:** Not all filters are available in all report types. Check the "Report Types" column to ensure compatibility.
+
+## Categories
+
+${FILTER_CATEGORIES.map((cat) => `- ${cat}`).join("\n")}
+
+---
+
+## Report Type-Specific Filters
+
+Some filters are ONLY available in specific report types:
+
+### YOUTUBE-Only Filters
+These TrueView filters require \`reportType: "YOUTUBE"\`:
+${Array.from(byReportType.get("YOUTUBE") || [])
+        .map(([f]) => `- \`${f}\``)
+        .join("\n") || "- None currently defined"}
+
+### GRP-Only Filters
+These Nielsen filters require \`reportType: "GRP"\`:
+${Array.from(byReportType.get("GRP") || [])
+        .map(([f]) => `- \`${f}\``)
+        .join("\n") || "- None currently defined"}
+
+### YOUTUBE_PROGRAMMATIC_GUARANTEED-Only Filters
+These filters require \`reportType: "YOUTUBE_PROGRAMMATIC_GUARANTEED"\`:
+${Array.from(byReportType.get("YOUTUBE_PROGRAMMATIC_GUARANTEED") || [])
+        .map(([f]) => `- \`${f}\``)
+        .join("\n") || "- None currently defined"}
+
+---
+
+`;
+    const sortedCategories = Array.from(byCategory.keys()).sort();
+    for (const category of sortedCategories) {
+        const filters = byCategory.get(category);
+        markdown += `## ${category} Filters (${filters.length})\n\n`;
+        markdown += "| Filter | Display Name | Report Types | Usage |\n";
+        markdown += "|--------|--------------|--------------|-------|\n";
+        filters.sort((a, b) => a[0].localeCompare(b[0]));
+        for (const [filter, meta] of filters) {
+            const usageStr = meta.usage.join(", ");
+            const reportTypes = meta.reportTypes?.join(", ") || "All";
+            markdown += `| \`${filter}\` | ${meta.displayName} | ${reportTypes} | ${usageStr} |\n`;
+        }
+        markdown += "\n";
+    }
+    markdown += `---
+
+## Common Filter Combinations
+
+### Daily Delivery by Campaign
+\`\`\`json
+{
+  "groupBys": ["FILTER_DATE", "FILTER_MEDIA_PLAN"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" }
+  ]
+}
+\`\`\`
+
+### Device Type Breakdown
+\`\`\`json
+{
+  "groupBys": ["FILTER_DEVICE_TYPE"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" },
+    { "type": "FILTER_MEDIA_PLAN", "value": "789012" }
+  ]
+}
+\`\`\`
+
+### Geographic Performance
+\`\`\`json
+{
+  "groupBys": ["FILTER_COUNTRY", "FILTER_REGION"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" }
+  ]
+}
+\`\`\`
+
+### Line Item Performance
+\`\`\`json
+{
+  "groupBys": ["FILTER_LINE_ITEM"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" },
+    { "type": "FILTER_MEDIA_PLAN", "value": "789012" }
+  ]
+}
+\`\`\`
+
+### Time of Day Analysis
+\`\`\`json
+{
+  "groupBys": ["FILTER_TIME_OF_DAY", "FILTER_DAY_OF_WEEK"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" }
+  ]
+}
+\`\`\`
+
+### Creative Performance
+\`\`\`json
+{
+  "groupBys": ["FILTER_CREATIVE", "FILTER_CREATIVE_SIZE"],
+  "filters": [
+    { "type": "FILTER_ADVERTISER", "value": "123456" },
+    { "type": "FILTER_LINE_ITEM", "value": "345678" }
+  ]
+}
+\`\`\`
+`;
+    return markdown;
+}
+function formatFiltersCategoryMarkdown(category) {
+    const cacheKey = toCategorySlug(category);
+    const cached = cachedCategoryMarkdown.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const filters = Object.entries(FILTER_METADATA)
+        .filter(([, meta]) => meta.category === category)
+        .sort((a, b) => a[0].localeCompare(b[0]));
+    let markdown = `# ${category} Filter Types
+
+This resource contains only \`${category}\` filters from the full \`filter-types://all\` reference.
+
+| Filter | Display Name | Report Types | Usage |
+|--------|--------------|--------------|-------|
+`;
+    for (const [filter, meta] of filters) {
+        const usageStr = meta.usage.join(", ");
+        const reportTypes = meta.reportTypes?.join(", ") || "All";
+        markdown += `| \`${filter}\` | ${meta.displayName} | ${reportTypes} | ${usageStr} |\n`;
+    }
+    markdown += `
+---
+
+Need the full catalog? Use \`filter-types://all\`.
+`;
+    cachedCategoryMarkdown.set(cacheKey, markdown);
+    return markdown;
+}
+export const filterTypesResource = {
+    uri: "filter-types://all",
+    name: "Bid Manager Filter/Dimension Types",
+    description: `Complete reference of all ${Object.keys(FILTER_METADATA).length} available Bid Manager API filters and dimensions`,
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedFiltersMarkdown ??= formatFiltersMarkdown();
+        return cachedFiltersMarkdown;
+    },
+};
+export const filterTypeCategoryResources = FILTER_CATEGORIES.map((category) => ({
+    uri: `filter-types://category/${toCategorySlug(category)}`,
+    name: `Bid Manager Filter Types (${category})`,
+    description: `Filter/dimension reference for ${category} category`,
+    mimeType: "text/markdown",
+    getContent: () => formatFiltersCategoryMarkdown(category),
+}));
+//# sourceMappingURL=filter-types.resource.js.map

package/dist/mcp-server/resources/definitions/filter-types.resource.js.map

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

package/dist/mcp-server/resources/definitions/index.d.ts

@@ -0,0 +1,8 @@
+export { metricTypesResource, metricTypeCategoryResources } from "./metric-types.resource.js";
+export { filterTypesResource, filterTypeCategoryResources } from "./filter-types.resource.js";
+export { queryExamplesResource, QUERY_EXAMPLES } from "./query-examples.resource.js";
+export { reportTypesResource } from "./report-types.resource.js";
+export { compatibilityRulesResource } from "./compatibility-rules.resource.js";
+import type { Resource } from "../types.js";
+export declare const allResources: Resource[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAS/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+B5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EAUlC,CAAC"}