@kaminari-ad/mcp 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.26.0] - 2026-10-06
+
+> Requires the API-side bulk parity deploy. Until it lands, the API
+> silently ignores the new `create_bulk_scans` fields. Do not tag this
+> release ahead of the API.
+
+### Added
+
+- **`create_bulk_scans` takes the same optional fields as `create_scan`.**
+  `campaign_id`, `run_id`, `ad_discovery`, `max_discovered_ads` and
+  `ad_formats` apply to every country in the batch. With a `campaign_id`,
+  bulk scans can raise alerts.
+
+### Changed
+
+- **`campaign_id` explains that alerts depend on it**, on both scan tools.
+  The three shared fields now live in one module, so the two tools'
+  descriptions cannot drift. Request schemas are regenerated from the API,
+  and country codes are documented as case-insensitive.
+
 ## [0.25.0] - 2026-10-04
 
 > Requires the API-side batch rule test deploy. Until it lands, the tool

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { NAME, VERSION, err, ok } from './chunk-IG36AHO3.js';
+import { NAME, VERSION, err, ok } from './chunk-DZ5IF6SC.js';
 import process from 'process';
 import { z } from 'zod';
 
@@ -162,10 +162,10 @@ async function main() {
   }
   const config = configResult.value;
   if (config.transport === "stdio") {
-    const { bootstrapStdio } = await import('./stdio-bootstrap-3IOUWYG3.js');
+    const { bootstrapStdio } = await import('./stdio-bootstrap-SD25OPK7.js');
     return bootstrapStdio(config);
   }
-  const { bootstrapHttp } = await import('./http-bootstrap-6L4VQJRM.js');
+  const { bootstrapHttp } = await import('./http-bootstrap-AR3RJBCT.js');
   return bootstrapHttp(config);
 }
 main().then(

package/dist/{chunk-IG36AHO3.js → chunk-DZ5IF6SC.js}

@@ -3,8 +3,8 @@ export { err, ok } from 'neverthrow';
 
 // src/shared/version.ts
 var NAME = "@kaminari-ad/mcp";
-var VERSION = "0.25.0";
+var VERSION = "0.26.0";
 
 export { NAME, VERSION };
-//# sourceMappingURL=chunk-IG36AHO3.js.map
-//# sourceMappingURL=chunk-IG36AHO3.js.map
+//# sourceMappingURL=chunk-DZ5IF6SC.js.map
+//# sourceMappingURL=chunk-DZ5IF6SC.js.map

package/dist/{chunk-IG36AHO3.js.map → chunk-DZ5IF6SC.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/shared/version.ts"],"names":[],"mappings":";;;;AASO,IAAM,IAAA,GAAO;AACb,IAAM,OAAA,GAAU","file":"chunk-IG36AHO3.js","sourcesContent":["/**\n * Package version and name. Hard-coded as constants here, asserted to\n * match `package.json` by a unit test.\n *\n * Why not import `package.json`: it would force JSON-module support at\n * runtime and tsup-bundling would inline the entire manifest. Two\n * constants + one assertion test is simpler and gives the same safety.\n */\n\nexport const NAME = \"@kaminari-ad/mcp\";\nexport const VERSION = \"0.25.0\";\n"]}
+{"version":3,"sources":["../src/shared/version.ts"],"names":[],"mappings":";;;;AASO,IAAM,IAAA,GAAO;AACb,IAAM,OAAA,GAAU","file":"chunk-DZ5IF6SC.js","sourcesContent":["/**\n * Package version and name. Hard-coded as constants here, asserted to\n * match `package.json` by a unit test.\n *\n * Why not import `package.json`: it would force JSON-module support at\n * runtime and tsup-bundling would inline the entire manifest. Two\n * constants + one assertion test is simpler and gives the same safety.\n */\n\nexport const NAME = \"@kaminari-ad/mcp\";\nexport const VERSION = \"0.26.0\";\n"]}

package/dist/{chunk-MIDK3IA2.js → chunk-G5DUWW6D.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { err, ok } from './chunk-IG36AHO3.js';
+import { err, ok } from './chunk-DZ5IF6SC.js';
 import { createHash, randomUUID } from 'crypto';
 import createClient from 'openapi-fetch';
 import { fetch } from 'undici';
@@ -262,7 +262,6 @@ z.object({
   vast_tag: z.union([z.string(), z.null()]).optional(),
   referrer: z.union([z.string(), z.null()]).optional(),
   ignore_first_n_domains: z.number().int().gte(0).lte(5).optional().default(0),
-  country_code: z.string().min(2).max(2),
   emulator_id: z.string().min(1).max(100),
   proxy: ProxyTargetRequest.optional(),
   labels: z.record(z.string()).optional(),
@@ -273,7 +272,8 @@ z.object({
   ad_formats: z.union([z.array(AdKind), z.null()]).optional(),
   repeat_count: z.number().int().gte(1).optional().default(1),
   repeat_mode: RepeatModeType.optional(),
-  retry_max_attempts: z.number().int().gte(0).optional().default(0)
+  retry_max_attempts: z.number().int().gte(0).optional().default(0),
+  country_code: z.string().min(2).max(2)
 }).passthrough();
 var ScanStatus = z.enum([
   "pending",
@@ -461,13 +461,18 @@ z.object({
   vast_tag: z.union([z.string(), z.null()]).optional(),
   referrer: z.union([z.string(), z.null()]).optional(),
   ignore_first_n_domains: z.number().int().gte(0).lte(5).optional().default(0),
-  country_codes: z.array(z.string()).min(1),
   emulator_id: z.string().min(1).max(100),
   proxy: ProxyTargetRequest.optional(),
   labels: z.record(z.string()).optional(),
+  campaign_id: z.union([z.string(), z.null()]).optional(),
+  run_id: z.union([z.string(), z.null()]).optional(),
+  ad_discovery: z.boolean().optional().default(false),
+  max_discovered_ads: z.union([z.number(), z.null()]).optional(),
+  ad_formats: z.union([z.array(AdKind), z.null()]).optional(),
   repeat_count: z.number().int().gte(1).optional().default(1),
   repeat_mode: RepeatModeType.optional(),
-  retry_max_attempts: z.number().int().gte(0).optional().default(0)
+  retry_max_attempts: z.number().int().gte(0).optional().default(0),
+  country_codes: z.array(z.string().min(2).max(2)).min(1)
 }).passthrough();
 z.object({
   scope_type: z.enum(["last_n", "hours"]),
@@ -5477,6 +5482,15 @@ var cancelScanTool = {
     return ok(result.value);
   }
 };
+var scanCampaignIdField = z.string().uuid().optional().describe(
+  "Optional campaign UUID to attribute the scan to. Required for alerts: policies are attached to campaigns, so a scan without a campaign is checked and tagged but never raises an alert."
+);
+var scanRunIdField = z.string().uuid().optional().describe(
+  "Optional run UUID inside the campaign. Omit it to join the campaign's API run for the day."
+);
+var scanAdDiscoveryField = z.boolean().optional().describe(
+  "Publisher ad discovery: detect ad blocks on the page and spawn one child scan per detected ad (banner/video/pop). Only valid with `url`. Each child is a separate billed scan; list them with `list_scan_children`."
+);
 var scanProxyField = z.object({
   proxy_type: z.enum(["residential", "mobile"]).optional().describe(
     "Proxy network type. Default: residential. Residential and mobile are separate pools with separate catalogues, so pass the same value to `get_proxy_targeting` that you send here."
@@ -5508,15 +5522,22 @@ var CreateBulkScansInputShape = {
   ),
   referrer: scanReferrerField,
   ignore_first_n_domains: ignoreFirstNDomainsScanField,
-  country_codes: z.array(z.string().length(2)).min(1).max(50).describe("List of ISO 3166-1 alpha-2 country codes; one scan per country is created."),
+  country_codes: z.array(z.string().length(2)).min(1).max(50).describe(
+    "List of ISO 3166-1 alpha-2 country codes, any case; one scan per country is created."
+  ),
   emulator_id: z.string().min(1).max(100).describe("Device/OS profile slug; same for every country in the batch."),
   proxy: scanProxyField,
   labels: z.record(z.string()).optional().describe("Arbitrary metadata copied onto every created scan."),
+  campaign_id: scanCampaignIdField,
+  run_id: scanRunIdField,
+  ad_discovery: scanAdDiscoveryField,
+  max_discovered_ads: maxDiscoveredAdsField,
+  ad_formats: adFormatsField,
   ...repeatRetryFields
 };
 var createBulkScansTool = {
   name: "create_bulk_scans",
-  description: "Queue one new scan per country in a single call (e.g. test the same URL, ad-tag, or VAST video tag from US + DE + JP). COSTS N CREDITS where N = number of countries times `repeat_count`. Returns one entry per country; each entry's `repeat_scan_ids` lists that country's extra repeats.",
+  description: "Queue one new scan per country in a single call (e.g. test the same URL, ad-tag, or VAST video tag from US + DE + JP). Every other field applies to each country, `campaign_id` included. COSTS N CREDITS where N = number of countries times `repeat_count`. Returns one entry per country; each entry's `repeat_scan_ids` lists that country's extra repeats.",
   annotations: {
     title: "Create Bulk Scans",
     readOnlyHint: false,
@@ -5536,6 +5557,11 @@ var createBulkScansTool = {
       ...input.ignore_first_n_domains !== void 0 ? { ignore_first_n_domains: input.ignore_first_n_domains } : {},
       ...input.proxy !== void 0 ? { proxy: input.proxy } : {},
       ...input.labels !== void 0 ? { labels: input.labels } : {},
+      ...input.campaign_id !== void 0 ? { campaign_id: input.campaign_id } : {},
+      ...input.run_id !== void 0 ? { run_id: input.run_id } : {},
+      ...input.ad_discovery !== void 0 ? { ad_discovery: input.ad_discovery } : {},
+      ...input.max_discovered_ads !== void 0 ? { max_discovered_ads: input.max_discovered_ads } : {},
+      ...input.ad_formats !== void 0 ? { ad_formats: input.ad_formats } : {},
       ...pickRepeatRetryBody(input)
     };
     const result = await ctx.api.createBulkScans(body);
@@ -5559,11 +5585,9 @@ var CreateScanInputShape = {
   emulator_id: z.string().min(1).max(100).describe("Device/OS profile slug; use `list_emulators` to discover valid values."),
   proxy: scanProxyField,
   labels: z.record(z.string()).optional().describe("Arbitrary string -> string metadata attached to the scan."),
-  campaign_id: z.string().uuid().optional().describe("Optional campaign UUID to attribute the scan to."),
-  run_id: z.string().uuid().optional().describe("Optional run UUID inside the campaign."),
-  ad_discovery: z.boolean().optional().describe(
-    "Publisher ad discovery: detect ad blocks on the page and spawn one child scan per detected ad (banner/video/pop). Only valid with `url`. Each child is a separate billed scan; list them with `list_scan_children`."
-  ),
+  campaign_id: scanCampaignIdField,
+  run_id: scanRunIdField,
+  ad_discovery: scanAdDiscoveryField,
   max_discovered_ads: maxDiscoveredAdsField,
   ad_formats: adFormatsField,
   ...repeatRetryFields
@@ -6484,5 +6508,5 @@ function formatToolError(error) {
 }
 
 export { BearerToken, SERVER_INSTRUCTIONS, createHttpApiGateway, createPinoLogger, declareEmptyResourcesAndPrompts, newRequestId, wireToolsIntoMcpServer };
-//# sourceMappingURL=chunk-MIDK3IA2.js.map
-//# sourceMappingURL=chunk-MIDK3IA2.js.map
+//# sourceMappingURL=chunk-G5DUWW6D.js.map
+//# sourceMappingURL=chunk-G5DUWW6D.js.map