@kaminari-ad/mcp 0.7.2 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-07-10
+
+### Added
+
+- **VAST video-ad support.** `create_scan`, `create_bulk_scans`,
+  `create_campaign` (new `vast` campaign type), and `update_campaign` now
+  accept a `vast_tag` — an http(s) URL of a VAST endpoint or raw VAST XML —
+  mutually exclusive with `url` / `ad_tag`. Scan responses surface
+  `creative_kind` (`banner` | `video`) plus a `video` block (duration,
+  media-file URL, VAST version, ad system, VPAID flag, wrapper depth), and the
+  scan-list brief carries `is_vast`. Regenerated the OpenAPI type + zod-schema
+  snapshots against the updated `/api/v1` surface.
+
 ## [0.6.0] - 2026-06-30
 
 ### Changed

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { NAME, VERSION, err, ok } from './chunk-VTKVXW4G.js';
+import { NAME, VERSION, err, ok } from './chunk-SWFPWJ74.js';
 import process from 'process';
 import { z } from 'zod';
 
@@ -160,10 +160,10 @@ async function main() {
   }
   const config = configResult.value;
   if (config.transport === "stdio") {
-    const { bootstrapStdio } = await import('./stdio-bootstrap-CE2Y76DX.js');
+    const { bootstrapStdio } = await import('./stdio-bootstrap-6DXIUJTV.js');
     return bootstrapStdio(config);
   }
-  const { bootstrapHttp } = await import('./http-bootstrap-7VZLKAM4.js');
+  const { bootstrapHttp } = await import('./http-bootstrap-ZXECSCYN.js');
   return bootstrapHttp(config);
 }
 main().then(

package/dist/{chunk-NRDA7DQQ.js → chunk-E66U4JXR.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { err, ok } from './chunk-VTKVXW4G.js';
+import { err, ok } from './chunk-SWFPWJ74.js';
 import { createHash, randomUUID } from 'crypto';
 import createClient from 'openapi-fetch';
 import { fetch } from 'undici';
@@ -243,12 +243,14 @@ var ProxyTargetRequest = z.object({
 z.object({
   url: z.union([z.string(), z.null()]).optional(),
   ad_tag: z.union([z.string(), z.null()]).optional(),
+  vast_tag: z.union([z.string(), z.null()]).optional(),
   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(),
   campaign_id: z.union([z.string(), z.null()]).optional(),
-  run_id: z.union([z.string(), z.null()]).optional()
+  run_id: z.union([z.string(), z.null()]).optional(),
+  ad_discovery: z.boolean().optional().default(false)
 }).passthrough();
 var ScanStatus = z.enum([
   "pending",
@@ -282,6 +284,14 @@ var RedirectHopResponse = z.object({
   redirected_from: z.string(),
   sub_requests: z.array(SubRequestResponse)
 }).passthrough();
+var VideoMetaResponse = z.object({
+  duration_ms: z.number().int().default(0),
+  mediafile_url: z.string().default(""),
+  vast_version: z.string().default(""),
+  ad_system: z.string().default(""),
+  is_vpaid: z.boolean().default(false),
+  wrapper_depth: z.number().int().default(0)
+}).partial().passthrough();
 var ProxyTargetResponse = z.object({
   proxy_type: z.string(),
   region: z.string().optional().default(""),
@@ -335,15 +345,23 @@ var ScanResponse = z.object({
   country_code: z.string(),
   emulator_id: z.string(),
   status: ScanStatus,
+  parent_scan_id: z.union([z.string(), z.null()]).optional(),
+  ad_discovery: z.boolean().optional().default(false),
+  slot_index: z.union([z.number(), z.null()]).optional(),
+  ad_kind: z.union([z.string(), z.null()]).optional(),
+  network: z.string().optional().default(""),
   offer_url: z.string(),
   redirect_chain: z.array(RedirectHopResponse),
   screenshot_url: z.string().optional().default(""),
   report_url: z.string().optional().default(""),
   public_report_url: z.string().optional().default(""),
   ad_tag: z.union([z.string(), z.null()]).optional(),
+  vast_tag: z.union([z.string(), z.null()]).optional(),
+  creative_kind: z.string().optional().default("banner"),
   creative_screenshot_url: z.string().optional().default(""),
   creative_width: z.number().int().optional().default(0),
   creative_height: z.number().int().optional().default(0),
+  video: z.union([VideoMetaResponse, z.null()]).optional(),
   proxy: z.union([ProxyTargetResponse, z.null()]).optional(),
   page_title: z.string(),
   elapsed_ms: z.number().int(),
@@ -376,6 +394,12 @@ var ScanBriefResponse = z.object({
   campaign_id: z.union([z.string(), z.null()]).optional(),
   campaign_name: z.union([z.string(), z.null()]).optional(),
   is_ad_tag: z.boolean().optional().default(false),
+  is_vast: z.boolean().optional().default(false),
+  parent_scan_id: z.union([z.string(), z.null()]).optional(),
+  ad_discovery: z.boolean().optional().default(false),
+  slot_index: z.union([z.number(), z.null()]).optional(),
+  ad_kind: z.union([z.string(), z.null()]).optional(),
+  network: z.string().optional().default(""),
   emulator_display_name: z.string().optional().default(""),
   emulator_category: z.string().optional().default("")
 }).passthrough();
@@ -389,6 +413,7 @@ z.object({
 z.object({
   url: z.union([z.string(), z.null()]).optional(),
   ad_tag: z.union([z.string(), z.null()]).optional(),
+  vast_tag: z.union([z.string(), z.null()]).optional(),
   country_codes: z.array(z.string()).min(1),
   emulator_id: z.string().min(1).max(100),
   proxy: ProxyTargetRequest.optional(),
@@ -441,6 +466,7 @@ z.object({
   campaign_type: z.string().optional().default("url"),
   url: z.union([z.string(), z.null()]).optional(),
   ad_tag: z.union([z.string(), z.null()]).optional(),
+  vast_tag: z.union([z.string(), z.null()]).optional(),
   country_codes: z.array(z.string()).min(1),
   group_id: z.union([z.string(), z.null()]).optional(),
   emulator_categories: z.array(z.string()).optional(),
@@ -469,6 +495,7 @@ var CampaignResponse = z.object({
   campaign_type: z.string().optional().default("url"),
   url: z.string(),
   ad_tag: z.union([z.string(), z.null()]).optional(),
+  vast_tag: z.union([z.string(), z.null()]).optional(),
   country_codes: z.array(z.string()),
   group_id: z.string().uuid(),
   emulator_selection: EmulatorSelectionResponse,
@@ -505,6 +532,7 @@ z.object({
   name: z.union([z.string(), z.null()]),
   url: z.union([z.string(), z.null()]),
   ad_tag: z.union([z.string(), z.null()]),
+  vast_tag: z.union([z.string(), z.null()]),
   country_codes: z.union([z.array(z.string()), z.null()]),
   group_id: z.union([z.string(), z.null()]),
   emulator_categories: z.union([z.array(z.string()), z.null()]),
@@ -1272,6 +1300,7 @@ var CampaignSchema = schemas.CampaignResponse.pick({
   campaign_type: true,
   url: true,
   ad_tag: true,
+  vast_tag: true,
   country_codes: true,
   group_id: true,
   emulator_selection: true,
@@ -1701,6 +1730,9 @@ var ScanSchema = schemas.ScanResponse.pick({
   report_url: true,
   public_report_url: true,
   ad_tag: true,
+  vast_tag: true,
+  creative_kind: true,
+  video: true,
   creative_screenshot_url: true,
   page_title: true,
   elapsed_ms: true,
@@ -1708,6 +1740,11 @@ var ScanSchema = schemas.ScanResponse.pick({
   labels: true,
   campaign_id: true,
   campaign_name: true,
+  parent_scan_id: true,
+  ad_discovery: true,
+  slot_index: true,
+  ad_kind: true,
+  network: true,
   created_at: true,
   completed_at: true
 }).strip();
@@ -1730,6 +1767,12 @@ var ScanBriefSchema = schemas.ScanBriefResponse.pick({
   campaign_id: true,
   campaign_name: true,
   is_ad_tag: true,
+  is_vast: true,
+  parent_scan_id: true,
+  ad_discovery: true,
+  slot_index: true,
+  ad_kind: true,
+  network: true,
   created_at: true
 }).strip();
 var parseScanPage = (raw) => parsePagedWithItemSchema(ScanBriefSchema, raw, "scans");
@@ -2013,6 +2056,14 @@ function createHttpApiGateway(config) {
         parseScan
       );
     },
+    async listScanChildren(scanId, filters) {
+      return call(
+        "GET",
+        "/api/v1/scans/{scan_id}/children",
+        { params: { path: { scan_id: scanId }, query: filters } },
+        parseScanPage
+      );
+    },
     async createScan(body) {
       return call("POST", "/api/v1/scans", { body }, parseScan);
     },
@@ -2603,8 +2654,10 @@ var SERVER_INSTRUCTIONS = [
   "- `report_url`: authenticated dashboard report (requires login).",
   "- `public_report_url`: shareable report (no login).",
   "- `screenshot_url` / `creative_screenshot_url`: absolute, directly followable.",
-  "These come from `get_scan`, `list_scans`, and `list_run_scans`. Do NOT assemble",
-  "scan/app URLs from a base host yourself \u2014 the apex domain does not serve scan pages."
+  "These come from `get_scan`, `list_scans`, `list_run_scans`, and `list_scan_children`.",
+  "Do NOT assemble scan/app URLs from a base host yourself \u2014 the apex domain does not serve scan pages.",
+  "Publisher ad discovery: create a scan with `ad_discovery: true` (url scans only) to detect",
+  "ad blocks on a page; `list_scan_children` returns one child scan per detected ad (banner/pop)."
 ].join("\n");
 function declareEmptyResourcesAndPrompts(server) {
   server.server.registerCapabilities({ resources: {}, prompts: {} });
@@ -3553,11 +3606,14 @@ function pickCampaignConfigBody(input) {
 // src/application/tools/campaigns/create-campaign.tool.ts
 var CreateCampaignInputShape = {
   name: z.string().min(1).max(200).describe("Display name (1-200 chars)."),
-  campaign_type: z.enum(["url", "ad_tag"]).describe("`url` or `ad_tag` \u2014 must match the target field below."),
+  campaign_type: z.enum(["url", "ad_tag", "vast"]).describe("`url`, `ad_tag`, or `vast` \u2014 must match the target field below."),
   url: z.string().url().optional().describe("Target URL (required if campaign_type=url)."),
   ad_tag: z.string().optional().describe(
     "Ad-tag HTML/JS or an http(s) URL of a page with the rendered creative (required if campaign_type=ad_tag)."
   ),
+  vast_tag: z.string().optional().describe(
+    "VAST video ad tag: an http(s) URL of a VAST endpoint OR raw VAST XML (required if campaign_type=vast)."
+  ),
   country_codes: z.array(z.string().length(2)).min(1).describe("ISO 3166-1 alpha-2 codes \u2014 one scan per country per run."),
   group_id: z.string().uuid().optional().describe("Parent group UUID; defaults to the org's default group."),
   ...campaignConfigFields,
@@ -3583,6 +3639,7 @@ var createCampaignTool = {
       country_codes: input.country_codes,
       ...input.url !== void 0 ? { url: input.url } : {},
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
+      ...input.vast_tag !== void 0 ? { vast_tag: input.vast_tag } : {},
       ...input.group_id !== void 0 ? { group_id: input.group_id } : {},
       ...input.labels !== void 0 ? { labels: input.labels } : {},
       ...input.policy_set_id !== void 0 ? { policy_set_id: input.policy_set_id } : {},
@@ -3599,7 +3656,7 @@ var GetCampaignInputShape = {
 };
 var getCampaignTool = {
   name: "get_campaign",
-  description: "Get one campaign by UUID: name, type, target URL/ad-tag, countries, schedule status, archive status, parent group.",
+  description: "Get one campaign by UUID: name, type (url|ad_tag|vast), target URL / ad-tag / VAST tag (vast_tag), countries, schedule status, archive status, parent group.",
   annotations: {
     title: "Get Campaign",
     readOnlyHint: true,
@@ -3750,6 +3807,9 @@ var UpdateCampaignInputShape = {
   ad_tag: z.string().optional().describe(
     "New ad-tag HTML/JS or an http(s) URL of a page with the rendered creative (ad_tag-type campaigns)."
   ),
+  vast_tag: z.string().optional().describe(
+    "New VAST video ad tag: an http(s) URL of a VAST endpoint OR raw VAST XML (vast-type campaigns)."
+  ),
   country_codes: z.array(z.string().length(2)).optional().describe("Replace the country list."),
   group_id: z.string().uuid().optional().describe("Move the campaign to another group."),
   ...campaignConfigFields,
@@ -3773,6 +3833,7 @@ var updateCampaignTool = {
       ...input.name !== void 0 ? { name: input.name } : {},
       ...input.url !== void 0 ? { url: input.url } : {},
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
+      ...input.vast_tag !== void 0 ? { vast_tag: input.vast_tag } : {},
       ...input.country_codes !== void 0 ? { country_codes: input.country_codes } : {},
       ...input.group_id !== void 0 ? { group_id: input.group_id } : {},
       ...input.labels !== void 0 ? { labels: input.labels } : {},
@@ -4603,9 +4664,12 @@ var scanProxyField = z.object({
 
 // src/application/tools/scans/create-bulk-scans.tool.ts
 var CreateBulkScansInputShape = {
-  url: z.string().url().optional().describe("Direct URL. EITHER `url` OR `ad_tag` is required."),
+  url: z.string().url().optional().describe("Direct URL. Provide exactly one of `url`, `ad_tag`, or `vast_tag`."),
   ad_tag: z.string().optional().describe(
-    "Raw ad-tag HTML/JS OR an http(s) URL of a page with the creative already rendered. EITHER `url` OR `ad_tag` is required."
+    "Raw ad-tag HTML/JS OR an http(s) URL of a page with the creative already rendered. Provide exactly one of `url`, `ad_tag`, or `vast_tag`."
+  ),
+  vast_tag: z.string().optional().describe(
+    "VAST video ad tag: an http(s) URL of a VAST endpoint OR raw VAST XML. Provide exactly one of `url`, `ad_tag`, or `vast_tag`."
   ),
   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."),
   emulator_id: z.string().min(1).max(100).describe("Device/OS profile slug; same for every country in the batch."),
@@ -4614,7 +4678,7 @@ var CreateBulkScansInputShape = {
 };
 var createBulkScansTool = {
   name: "create_bulk_scans",
-  description: "Queue one new scan per country in a single call (e.g. test the same URL from US + DE + JP). COSTS N CREDITS where N = number of countries. Returns the list of created 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. Returns the list of created scans.",
   annotations: {
     title: "Create Bulk Scans",
     readOnlyHint: false,
@@ -4629,6 +4693,7 @@ var createBulkScansTool = {
       emulator_id: input.emulator_id,
       ...input.url !== void 0 ? { url: input.url } : {},
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
+      ...input.vast_tag !== void 0 ? { vast_tag: input.vast_tag } : {},
       ...input.proxy !== void 0 ? { proxy: input.proxy } : {},
       ...input.labels !== void 0 ? { labels: input.labels } : {}
     };
@@ -4638,20 +4703,28 @@ var createBulkScansTool = {
   }
 };
 var CreateScanInputShape = {
-  url: z.string().url().optional().describe("Direct URL of the ad / landing page. EITHER `url` OR `ad_tag` is required."),
+  url: z.string().url().optional().describe(
+    "Direct URL of the ad / landing page. Provide exactly one of `url`, `ad_tag`, or `vast_tag`."
+  ),
   ad_tag: z.string().optional().describe(
-    "Raw HTML/JS ad tag (script, iframe, image) OR an http(s) URL of a page with the creative already rendered. EITHER `url` OR `ad_tag` is required."
+    "Raw HTML/JS ad tag (script, iframe, image) OR an http(s) URL of a page with the creative already rendered. Provide exactly one of `url`, `ad_tag`, or `vast_tag`."
+  ),
+  vast_tag: z.string().optional().describe(
+    "VAST video ad tag: an http(s) URL of a VAST endpoint OR raw VAST XML (a document containing a <VAST> element). Fetched and played in a real browser. Provide exactly one of `url`, `ad_tag`, or `vast_tag`."
   ),
   country_code: z.string().length(2).describe("ISO 3166-1 alpha-2 country code, e.g. US, DE, JP. Determines proxy geo."),
   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.")
+  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/pop). Only valid with `url`. Each child is a separate billed scan; list them with `list_scan_children`."
+  )
 };
 var createScanTool = {
   name: "create_scan",
-  description: "Queue a single new scan for a URL or ad-tag against one country. COSTS CREDITS and bills the caller's organization. Returns the newly-created scan record.",
+  description: "Queue a single new scan for a URL, ad-tag, or VAST video tag against one country. COSTS CREDITS and bills the caller's organization. Returns the newly-created scan record.",
   annotations: {
     title: "Create Scan",
     readOnlyHint: false,
@@ -4666,10 +4739,12 @@ var createScanTool = {
       emulator_id: input.emulator_id,
       ...input.url !== void 0 ? { url: input.url } : {},
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
+      ...input.vast_tag !== void 0 ? { vast_tag: input.vast_tag } : {},
       ...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.run_id !== void 0 ? { run_id: input.run_id } : {},
+      ...input.ad_discovery !== void 0 ? { ad_discovery: input.ad_discovery } : {}
     };
     const result = await ctx.api.createScan(body);
     if (result.isErr()) return err(mapApiError(result.error));
@@ -4681,7 +4756,7 @@ var GetScanInputShape = {
 };
 var getScanTool = {
   name: "get_scan",
-  description: "Get full detail for one scan by UUID: status, offer URL, absolute screenshot URL, report_url + public_report_url deep-links, timing, labels, and the parent campaign if any. Link users with the returned `report_url` / `public_report_url` \u2014 never construct URLs yourself.",
+  description: "Get full detail for one scan by UUID: status, offer URL, absolute screenshot URL, report_url + public_report_url deep-links, timing, labels, and the parent campaign if any. VAST video scans also carry `vast_tag`, `creative_kind` (banner|video), and a `video` block (duration, media-file URL, VAST version, ad system, VPAID flag, wrapper depth). Link users with the returned `report_url` / `public_report_url` \u2014 never construct URLs yourself.",
   annotations: {
     title: "Get Scan",
     readOnlyHint: true,
@@ -4766,6 +4841,31 @@ var getScanScreenshotTool = {
     return ok(imageBlock(result.value.bytes, result.value.contentType));
   }
 };
+var ListScanChildrenInputShape = {
+  scan_id: z.string().uuid().describe("The publisher scan's UUID (an ad-discovery scan created with ad_discovery=true)."),
+  page: z.number().int().min(1).max(500).default(1).describe("1-indexed page number."),
+  limit: z.number().int().min(1).max(200).default(50).describe("Page size (1-200). Default 50.")
+};
+var listScanChildrenTool = {
+  name: "list_scan_children",
+  description: "List the discovered-ad child scans of a publisher ad-discovery scan \u2014 one per detected ad block on the page. Each child brief carries ad_kind (banner|pop), the attributed ad network, and slot_index. Returns a paginated envelope with screenshot + report deep-links; link users with those, never hand-build URLs.",
+  annotations: {
+    title: "List Scan Children",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  inputSchema: z.object(ListScanChildrenInputShape),
+  handler: async (input, ctx) => {
+    const result = await ctx.api.listScanChildren(input.scan_id, {
+      page: input.page,
+      limit: input.limit
+    });
+    if (result.isErr()) return err(mapApiError(result.error));
+    return ok(result.value);
+  }
+};
 var ListScansInputShape = {
   status: z.string().optional().describe(
     "Comma-separated statuses to filter by. Lifecycle values: pending, running, crawled, checking, checking_async, completed, partial, failed, cancelled."
@@ -4799,7 +4899,7 @@ var ListScansInputShape = {
 };
 var listScansTool = {
   name: "list_scans",
-  description: "List scans for the caller's organization with optional filters (status, country, URL substring, date range, run/campaign/group, tag, AI/IAB/brand category, dynamic labels). Returns a paginated envelope; each scan carries an absolute screenshot URL plus report_url (auth dashboard) and public_report_url (shareable) deep-links \u2014 link users with those, never hand-build URLs.",
+  description: "List scans for the caller's organization with optional filters (status, country, URL substring, date range, run/campaign/group, tag, AI/IAB/brand category, dynamic labels). Returns a paginated envelope; each brief carries `is_ad_tag` and `is_vast` flags, an absolute screenshot URL plus report_url (auth dashboard) and public_report_url (shareable) deep-links \u2014 link users with those, never hand-build URLs.",
   annotations: {
     title: "List Scans",
     readOnlyHint: true,
@@ -5272,6 +5372,7 @@ function registerAllTools(register) {
   register(listGeosTool);
   register(listEmulatorsTool);
   register(getScanTool);
+  register(listScanChildrenTool);
   register(listScansTool);
   register(cancelScanTool);
   register(createBulkScansTool);
@@ -5432,5 +5533,5 @@ function formatToolError(error) {
 }
 
 export { BearerToken, SERVER_INSTRUCTIONS, createHttpApiGateway, createPinoLogger, declareEmptyResourcesAndPrompts, newRequestId, wireToolsIntoMcpServer };
-//# sourceMappingURL=chunk-NRDA7DQQ.js.map
-//# sourceMappingURL=chunk-NRDA7DQQ.js.map
+//# sourceMappingURL=chunk-E66U4JXR.js.map
+//# sourceMappingURL=chunk-E66U4JXR.js.map