@kaminari-ad/mcp 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.17.1] - 2026-09-03
+
+### Fixed
+
+- **The screenshot tools said PNG; the API has only ever sent WebP.**
+  `get_scan_screenshot` and `get_scan_creative_screenshot` advertised
+  "base64-encoded PNG", while every screenshot route on the API side
+  hardcodes `image/webp` — the crawler writes WebP and the legacy `.png`
+  keys were backfilled long ago. `get_scan_landing_screenshot` named no
+  format at all. All three now name WebP and say outright that the
+  client has to be able to decode it.
+
+  No transcoding was added, deliberately: this server does no image
+  processing at all — it base64-encodes the bytes it received and passes
+  the response's own content type through. A client that cannot read
+  WebP has to handle that on its own side, and an error such as
+  `webp codec not registered: registerWebpCodec() must be called by a
+  Node server` comes from the client, not from here and not from the
+  API.
+
 ## [0.17.0] - 2026-09-03
 
 ### Added

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { NAME, VERSION, err, ok } from './chunk-OX65SNEN.js';
+import { NAME, VERSION, err, ok } from './chunk-KCQ55TRV.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-NVDBVJ7K.js');
+    const { bootstrapStdio } = await import('./stdio-bootstrap-ZWMO4KXK.js');
     return bootstrapStdio(config);
   }
-  const { bootstrapHttp } = await import('./http-bootstrap-DKGGQURI.js');
+  const { bootstrapHttp } = await import('./http-bootstrap-WTWLW2LP.js');
   return bootstrapHttp(config);
 }
 main().then(

package/dist/{chunk-OX65SNEN.js → chunk-KCQ55TRV.js}

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

package/dist/{chunk-OX65SNEN.js.map → chunk-KCQ55TRV.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/shared/version.ts"],"names":[],"mappings":";;;;AASO,IAAM,IAAA,GAAO;AACb,IAAM,OAAA,GAAU","file":"chunk-OX65SNEN.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.17.0\";\n"]}
+{"version":3,"sources":["../src/shared/version.ts"],"names":[],"mappings":";;;;AASO,IAAM,IAAA,GAAO;AACb,IAAM,OAAA,GAAU","file":"chunk-KCQ55TRV.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.18.0\";\n"]}

package/dist/{chunk-FA5A6Y4H.js → chunk-MYBWPFWG.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { err, ok } from './chunk-OX65SNEN.js';
+import { err, ok } from './chunk-KCQ55TRV.js';
 import { createHash, randomUUID } from 'crypto';
 import createClient from 'openapi-fetch';
 import { fetch } from 'undici';
@@ -1348,8 +1348,6 @@ var BillingSummarySchema = schemas.BillingSummaryResponse.pick({
   scheduled_effective_at: true
 }).strip();
 var parseBillingSummary = (raw) => parseWithSchema(BillingSummarySchema, raw, "billing-summary");
-
-// src/infrastructure/api/parsers/parse-campaign.ts
 var CampaignSchema = schemas.CampaignResponse.pick({
   id: true,
   name: true,
@@ -1378,7 +1376,7 @@ var CampaignSchema = schemas.CampaignResponse.pick({
   is_archived: true,
   created_at: true,
   last_run_at: true
-}).extend({ repeat_mode: schemas.RepeatMode.default("isolated") }).strip();
+}).extend({ repeat_mode: schemas.RepeatMode.default("isolated") }).extend({ max_discovered_ads: z.number().int().nullable().optional() }).strip();
 var parseCampaign = (raw) => parseWithSchema(CampaignSchema, raw, "campaign");
 var parseCampaignPage = (raw) => parsePagedWithItemSchema(CampaignSchema, raw, "campaigns");
 
@@ -1840,7 +1838,7 @@ var ScanSchema = schemas.ScanResponse.pick({
   repeat_scan_ids: true,
   retry_attempt: true,
   retry_max_attempts: true
-}).extend({ creative_kind: z.string().default("banner") }).strip();
+}).extend({ creative_kind: z.string().default("banner") }).extend({ max_discovered_ads: z.number().int().nullable().optional() }).strip();
 var ScanArraySchema = z.array(ScanSchema);
 var parseScan = (raw) => parseWithSchema(ScanSchema, raw, "scan");
 var parseScanArray = (raw) => parseWithSchema(ScanArraySchema, raw, "scans");
@@ -3892,6 +3890,15 @@ var cancelCampaignTool = {
     return ok(result.value);
   }
 };
+var MAX_DISCOVERED_ADS_DESCRIPTION = 'How many ad blocks to look for on each publisher page before stopping (1-25). Every ad found becomes its own scan with its own report and is BILLED AS A SEPARATE CHECK, so this multiplies the cost: a page scanned at 25 can cost 26 checks \u2014 one parent plus its children. Only valid on an ad-discovery target \u2014 `ad_discovery: true` on a scan, or `campaign_type: "ad_discovery"` on a campaign \u2014 and rejected with 422 anywhere else.';
+var PLATFORM_DEFAULT_NOTE = "The platform default is 12 unless an operator retuned it.";
+var maxDiscoveredAds = z.number().int().min(1).max(25);
+var maxDiscoveredAdsField = maxDiscoveredAds.optional().describe(
+  `${MAX_DISCOVERED_ADS_DESCRIPTION} Omit it to use the platform default. ` + PLATFORM_DEFAULT_NOTE
+);
+var maxDiscoveredAdsUpdateField = maxDiscoveredAds.nullable().optional().describe(
+  `${MAX_DISCOVERED_ADS_DESCRIPTION} Omitting the field leaves the campaign's current setting unchanged; pass null to drop its own number and go back to the platform default. ${PLATFORM_DEFAULT_NOTE}`
+);
 var repeatRetryFields = {
   repeat_count: z.number().int().min(1).max(20).optional().describe(
     "How many times to repeat every scan this call already produces (1-20). It is a multiplier on top of the tool's own fan-out \u2014 see that tool's description for the exact formula \u2014 and each resulting repeat is a full scan with its own report and its own billing. 1-20 is the API's default ceiling; an operator can lower it during an incident, and then a value accepted here still comes back as a 422 from the API. Default: 1."
@@ -3986,6 +3993,7 @@ var CreateCampaignInputShape = {
     "VAST video ad tag: an http(s) URL of a VAST endpoint OR raw VAST XML (required if campaign_type=vast)."
   ),
   referrer: campaignReferrerField,
+  max_discovered_ads: maxDiscoveredAdsField,
   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,
@@ -4013,6 +4021,7 @@ var createCampaignTool = {
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
       ...input.vast_tag !== void 0 ? { vast_tag: input.vast_tag } : {},
       ...input.referrer !== void 0 ? { referrer: input.referrer } : {},
+      ...input.max_discovered_ads !== void 0 ? { max_discovered_ads: input.max_discovered_ads } : {},
       ...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 } : {},
@@ -4186,6 +4195,7 @@ var UpdateCampaignInputShape = {
     "New VAST video ad tag: an http(s) URL of a VAST endpoint OR raw VAST XML (vast-type campaigns)."
   ),
   referrer: campaignReferrerUpdateField,
+  max_discovered_ads: maxDiscoveredAdsUpdateField,
   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,
@@ -4195,7 +4205,7 @@ var UpdateCampaignInputShape = {
 };
 var updateCampaignTool = {
   name: "update_campaign",
-  description: "Update one or more fields of a campaign. Fields not supplied are left unchanged. `policy_set_id` accepts null to clear the binding, and `referrer` accepts null to clear the publisher page scans are checked from.",
+  description: "Update one or more fields of a campaign. Fields not supplied are left unchanged. `policy_set_id` accepts null to clear the binding, `referrer` accepts null to clear the publisher page scans are checked from, and `max_discovered_ads` accepts null to go back to the platform ad cap.",
   annotations: {
     title: "Update Campaign",
     readOnlyHint: false,
@@ -4211,6 +4221,7 @@ var updateCampaignTool = {
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
       ...input.vast_tag !== void 0 ? { vast_tag: input.vast_tag } : {},
       ...input.referrer !== void 0 ? { referrer: input.referrer } : {},
+      ...input.max_discovered_ads !== void 0 ? { max_discovered_ads: input.max_discovered_ads } : {},
       ...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 } : {},
@@ -5314,6 +5325,7 @@ var CreateScanInputShape = {
   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`."
   ),
+  max_discovered_ads: maxDiscoveredAdsField,
   ...repeatRetryFields
 };
 var createScanTool = {
@@ -5340,6 +5352,7 @@ var createScanTool = {
       ...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 } : {},
       ...pickRepeatRetryBody(input)
     };
     const result = await ctx.api.createScan(body);
@@ -5399,7 +5412,7 @@ var GetScanCreativeScreenshotInputShape = {
 };
 var getScanCreativeScreenshotTool = {
   name: "get_scan_creative_screenshot",
-  description: "Fetch the creative screenshot for an ad-tag scan as an inline image (base64-encoded PNG). Returns 404 if the scan is not an ad-tag scan or has no creative captured yet.",
+  description: "Fetch the creative screenshot for an ad-tag scan as an inline image (base64-encoded WebP \u2014 the API stores and serves every screenshot as WebP, so the client must be able to decode it). Returns 404 if the scan is not an ad-tag scan or has no creative captured yet.",
   annotations: {
     title: "Get Scan Creative Screenshot",
     readOnlyHint: true,
@@ -5444,7 +5457,7 @@ var GetScanLandingScreenshotInputShape = {
 };
 var getScanLandingScreenshotTool = {
   name: "get_scan_landing_screenshot",
-  description: "Fetch the screenshot of one landing tab on an ad-tag scan as an inline image. Use `get_scan` first to discover available `landings[*].ord` values.",
+  description: "Fetch the screenshot of one landing tab on an ad-tag scan as an inline image (base64-encoded WebP \u2014 the API stores and serves every screenshot as WebP, so the client must be able to decode it). Use `get_scan` first to discover available `landings[*].ord` values.",
   annotations: {
     title: "Get Scan Landing Screenshot",
     readOnlyHint: true,
@@ -5471,7 +5484,7 @@ var GetScanScreenshotInputShape = {
 };
 var getScanScreenshotTool = {
   name: "get_scan_screenshot",
-  description: "Fetch the primary screenshot for a scan as an inline image (base64-encoded PNG). Pass `width` to request a resized version (50-2000 px). Returns one MCP image content block.",
+  description: "Fetch the primary screenshot for a scan as an inline image (base64-encoded WebP \u2014 the API stores and serves every screenshot as WebP, so the client must be able to decode it). Pass `width` to request a resized version (50-2000 px). Returns one MCP image content block.",
   annotations: {
     title: "Get Scan Screenshot",
     readOnlyHint: true,
@@ -6227,5 +6240,5 @@ function formatToolError(error) {
 }
 
 export { BearerToken, SERVER_INSTRUCTIONS, createHttpApiGateway, createPinoLogger, declareEmptyResourcesAndPrompts, newRequestId, wireToolsIntoMcpServer };
-//# sourceMappingURL=chunk-FA5A6Y4H.js.map
-//# sourceMappingURL=chunk-FA5A6Y4H.js.map
+//# sourceMappingURL=chunk-MYBWPFWG.js.map
+//# sourceMappingURL=chunk-MYBWPFWG.js.map