@kaminari-ad/mcp 0.3.0 → 0.5.0

package/dist/{chunk-W7TPFRJB.js → chunk-6FT6HKOB.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { err, ok } from './chunk-KTQBHJUB.js';
+import { err, ok } from './chunk-PG5IDZWQ.js';
 import { createHash, randomUUID } from 'crypto';
 import createClient from 'openapi-fetch';
 import { fetch } from 'undici';
@@ -332,6 +332,8 @@ var ScanResponse = z.object({
   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(),
   creative_screenshot_url: z.string().optional().default(""),
   creative_width: z.number().int().optional().default(0),
@@ -357,6 +359,8 @@ var ScanBriefResponse = z.object({
   status: ScanStatus,
   offer_url: z.string(),
   screenshot_url: z.string().optional().default(""),
+  report_url: z.string().optional().default(""),
+  public_report_url: z.string().optional().default(""),
   labels: z.record(z.string()).optional(),
   classification: z.union([ScanClassificationResponse, z.null()]).optional(),
   elapsed_ms: z.number().int(),
@@ -533,6 +537,8 @@ var ScanTileResponse = z.object({
   status: z.string(),
   offer_url: z.string().optional().default(""),
   screenshot_url: z.string().optional().default(""),
+  report_url: z.string().optional().default(""),
+  public_report_url: z.string().optional().default(""),
   elapsed_ms: z.number().int().optional().default(0),
   error: z.string().optional().default("")
 }).passthrough();
@@ -1201,7 +1207,13 @@ var BillingSummarySchema = schemas.BillingSummaryResponse.pick({
   is_suspended: true,
   can_create_scan: true,
   billing_mode: true,
-  block_reason: true
+  block_reason: true,
+  current_plan_is_custom: true,
+  credit_limit_micros: true,
+  effective_minimum_balance_micros: true,
+  scheduled_next_plan_id: true,
+  scheduled_next_plan_name: true,
+  scheduled_effective_at: true
 }).strip();
 var parseBillingSummary = (raw) => parseWithSchema(BillingSummarySchema, raw, "billing-summary");
 
@@ -1214,10 +1226,18 @@ var CampaignSchema = schemas.CampaignResponse.pick({
   ad_tag: true,
   country_codes: true,
   group_id: true,
+  emulator_selection: true,
+  proxy_type: true,
+  proxy_region: true,
+  proxy_city: true,
+  proxy_isp: true,
   labels: true,
   policy_set_id: true,
   schedule_enabled: true,
   schedule_type: true,
+  schedule_weekly: true,
+  schedule_interval_seconds: true,
+  schedule_timezone: true,
   is_archived: true,
   created_at: true,
   last_run_at: true
@@ -1390,6 +1410,7 @@ var UserSchema = schemas.UserResponse.pick({
   id: true,
   email: true,
   name: true,
+  role_id: true,
   role_name: true,
   is_active: true,
   created_at: true
@@ -1615,6 +1636,8 @@ var ScanTileSchema = schemas.ScanTileResponse.pick({
   status: true,
   offer_url: true,
   screenshot_url: true,
+  report_url: true,
+  public_report_url: true,
   elapsed_ms: true,
   error: true
 }).strip();
@@ -1627,6 +1650,8 @@ var ScanSchema = schemas.ScanResponse.pick({
   status: true,
   offer_url: true,
   screenshot_url: true,
+  report_url: true,
+  public_report_url: true,
   ad_tag: true,
   creative_screenshot_url: true,
   page_title: true,
@@ -1650,6 +1675,8 @@ var ScanBriefSchema = schemas.ScanBriefResponse.pick({
   status: true,
   offer_url: true,
   screenshot_url: true,
+  report_url: true,
+  public_report_url: true,
   labels: true,
   elapsed_ms: true,
   campaign_id: true,
@@ -2519,6 +2546,18 @@ function wrap(impl) {
     }
   };
 }
+
+// src/shared/server-instructions.ts
+var SERVER_INSTRUCTIONS = [
+  "Kaminari Ad \u2014 ad-verification API (malvertising, scams, policy violations).",
+  "",
+  "Linking to a scan: use the URL fields the tools return \u2014 never build or guess them.",
+  "- `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."
+].join("\n");
 function declareEmptyResourcesAndPrompts(server) {
   server.server.registerCapabilities({ resources: {}, prompts: {} });
   server.server.setRequestHandler(ListResourcesRequestSchema, async () => {
@@ -2637,7 +2676,8 @@ var getAccountTool = {
 var InviteUserInputShape = {
   email: z.string().email().describe("Email of the person to invite. They get a signup link."),
   role_id: z.string().uuid().describe("UUID of the role to assign on accept. Get UUIDs from `list_org_roles`."),
-  name: z.string().min(1).optional().describe("Optional display name for the invitee.")
+  name: z.string().min(1).optional().describe("Optional display name for the invitee."),
+  timezone: z.string().optional().describe("Optional IANA timezone for the invitee, e.g. 'Europe/Berlin'. Default: UTC.")
 };
 var inviteUserTool = {
   name: "invite_user",
@@ -2656,6 +2696,7 @@ var inviteUserTool = {
       role_id: input.role_id
     };
     if (input.name !== void 0) body.name = input.name;
+    if (input.timezone !== void 0) body.timezone = input.timezone;
     const result = await ctx.api.inviteUser(body);
     if (result.isErr()) return err(mapApiError(result.error));
     return ok(result.value);
@@ -2833,12 +2874,11 @@ var updateAccountLabelsTool = {
   }
 };
 var UpdateOrgInputShape = {
-  name: z.string().min(1).max(200).optional().describe("New organization display name."),
-  settings: z.record(z.unknown()).optional().describe("Replacement settings object. Fields not supplied are left unchanged.")
+  name: z.string().min(1).max(200).optional().describe("New organization display name.")
 };
 var updateOrgTool = {
   name: "update_org",
-  description: "Update the caller's organization \u2014 display name and/or settings object. Only supplied fields are touched.",
+  description: "Update the caller's organization display name.",
   annotations: {
     title: "Update Organization",
     readOnlyHint: false,
@@ -2849,8 +2889,7 @@ var updateOrgTool = {
   inputSchema: z.object(UpdateOrgInputShape),
   handler: async (input, ctx) => {
     const body = {
-      ...input.name !== void 0 ? { name: input.name } : {},
-      ...input.settings !== void 0 ? { settings: input.settings } : {}
+      ...input.name !== void 0 ? { name: input.name } : {}
     };
     const result = await ctx.api.updateOrg(body);
     if (result.isErr()) return err(mapApiError(result.error));
@@ -3356,12 +3395,11 @@ var unarchiveCampaignGroupTool = {
 };
 var UpdateCampaignGroupInputShape = {
   group_id: z.string().uuid().describe("Group UUID to update."),
-  name: z.string().min(1).max(200).optional().describe("New display name."),
-  schedule_paused: z.boolean().optional().describe("Pause/resume the scheduler for every campaign in this group.")
+  name: z.string().min(1).max(200).optional().describe("New display name.")
 };
 var updateCampaignGroupTool = {
   name: "update_campaign_group",
-  description: "Update a campaign group: rename, or pause/resume the scheduler (the pause cascades to every campaign in the group).",
+  description: "Rename a campaign group. To pause/resume its scheduler, use `pause_campaign_group_schedule` / `resume_campaign_group_schedule` instead.",
   annotations: {
     title: "Update Campaign Group",
     readOnlyHint: false,
@@ -3372,8 +3410,7 @@ var updateCampaignGroupTool = {
   inputSchema: z.object(UpdateCampaignGroupInputShape),
   handler: async (input, ctx) => {
     const body = {
-      ...input.name !== void 0 ? { name: input.name } : {},
-      ...input.schedule_paused !== void 0 ? { schedule_paused: input.schedule_paused } : {}
+      ...input.name !== void 0 ? { name: input.name } : {}
     };
     const result = await ctx.api.updateCampaignGroup(input.group_id, body);
     if (result.isErr()) return err(mapApiError(result.error));
@@ -3420,6 +3457,52 @@ var cancelCampaignTool = {
     return ok(result.value);
   }
 };
+var campaignConfigFields = {
+  emulator_categories: z.array(z.string()).optional().describe(
+    "Device categories to rotate through, e.g. ['android_phone']. Valid: android_phone, android_tablet, iphone, ipad, windows_desktop, macos_desktop. On create, omitting this defaults to ['android_phone']; pass [] together with emulator_specific_ids to target ONLY specific devices."
+  ),
+  emulator_specific_ids: z.array(z.string()).optional().describe(
+    "Pin exact device profile slugs from `list_emulators` (the `id` field), e.g. ['samsung_galaxy_s23_ultra_android16']. Always scanned regardless of emulator_mode."
+  ),
+  emulator_mode: z.enum(["random", "all"]).optional().describe(
+    "How selected categories expand per run: 'random' = one random device per category (the UI's 'Random (1 per group)'), 'all' = every device in each category ('All checked'). Does not affect emulator_specific_ids. Default: random."
+  ),
+  proxy_type: z.enum(["residential", "mobile"]).optional().describe("Proxy network type. Default: residential."),
+  proxy_region: z.string().optional().describe("Proxy region/state targeting (free-text; only honoured for a single country)."),
+  proxy_city: z.string().optional().describe("Proxy city targeting."),
+  proxy_isp: z.string().optional().describe("Proxy ISP targeting."),
+  schedule_type: z.enum(["weekly", "interval"]).optional().describe(
+    "Scheduling mode: 'weekly' (run on a weekday/hour grid via schedule_weekly) or 'interval' (run every schedule_interval_seconds). Omit for a manual (run-on-demand) campaign."
+  ),
+  schedule_weekly: z.record(z.array(z.number().int().min(0).max(23))).optional().describe(
+    "Weekly run grid for schedule_type='weekly'. Keys are weekdays '0'-'6' (Mon-Sun); values are hours 0-23 in schedule_timezone, e.g. { '0': [9, 17], '4': [12] }."
+  ),
+  schedule_interval_seconds: z.number().int().optional().describe(
+    "Run interval for schedule_type='interval'. Allowed presets (seconds): 60, 120, 300, 600, 900, 1800, 2700, 3600, 7200, 14400, 28800, 86400."
+  ),
+  schedule_timezone: z.string().optional().describe("IANA timezone for the weekly grid, e.g. 'Europe/Berlin'. Default: UTC.")
+};
+function pickCampaignConfigBody(input) {
+  const body = {};
+  if (input.emulator_categories !== void 0) body.emulator_categories = input.emulator_categories;
+  if (input.emulator_specific_ids !== void 0) {
+    body.emulator_specific_ids = input.emulator_specific_ids;
+  }
+  if (input.emulator_mode !== void 0) body.emulator_mode = input.emulator_mode;
+  if (input.proxy_type !== void 0) body.proxy_type = input.proxy_type;
+  if (input.proxy_region !== void 0) body.proxy_region = input.proxy_region;
+  if (input.proxy_city !== void 0) body.proxy_city = input.proxy_city;
+  if (input.proxy_isp !== void 0) body.proxy_isp = input.proxy_isp;
+  if (input.schedule_type !== void 0) body.schedule_type = input.schedule_type;
+  if (input.schedule_weekly !== void 0) body.schedule_weekly = input.schedule_weekly;
+  if (input.schedule_interval_seconds !== void 0) {
+    body.schedule_interval_seconds = input.schedule_interval_seconds;
+  }
+  if (input.schedule_timezone !== void 0) body.schedule_timezone = input.schedule_timezone;
+  return body;
+}
+
+// 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."),
@@ -3427,7 +3510,7 @@ var CreateCampaignInputShape = {
   ad_tag: z.string().optional().describe("Ad-tag HTML/JS (required if campaign_type=ad_tag)."),
   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."),
-  emulator_categories: z.array(z.string()).optional().describe("Categories of device profiles to rotate through. Default: all available."),
+  ...campaignConfigFields,
   labels: z.record(z.string()).optional().describe("Arbitrary metadata applied to every queued scan."),
   policy_set_id: z.string().uuid().optional().describe("Policy set to evaluate every scan against."),
   schedule_enabled: z.boolean().optional().describe("If true, the scheduler runs immediately. Default: false (manual run).")
@@ -3451,10 +3534,10 @@ var createCampaignTool = {
       ...input.url !== void 0 ? { url: input.url } : {},
       ...input.ad_tag !== void 0 ? { ad_tag: input.ad_tag } : {},
       ...input.group_id !== void 0 ? { group_id: input.group_id } : {},
-      ...input.emulator_categories !== void 0 ? { emulator_categories: input.emulator_categories } : {},
       ...input.labels !== void 0 ? { labels: input.labels } : {},
       ...input.policy_set_id !== void 0 ? { policy_set_id: input.policy_set_id } : {},
-      ...input.schedule_enabled !== void 0 ? { schedule_enabled: input.schedule_enabled } : {}
+      ...input.schedule_enabled !== void 0 ? { schedule_enabled: input.schedule_enabled } : {},
+      ...pickCampaignConfigBody(input)
     };
     const result = await ctx.api.createCampaign(body);
     if (result.isErr()) return err(mapApiError(result.error));
@@ -3613,7 +3696,11 @@ var unarchiveCampaignTool = {
 var UpdateCampaignInputShape = {
   campaign_id: z.string().uuid().describe("Campaign UUID to update."),
   name: z.string().min(1).max(200).optional().describe("New display name."),
+  url: z.string().url().optional().describe("New target URL (url-type campaigns)."),
+  ad_tag: z.string().optional().describe("New ad-tag HTML/JS (ad_tag-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,
   labels: z.record(z.string()).optional().describe("Replace the label map."),
   policy_set_id: z.string().uuid().nullable().optional().describe("New policy set UUID; pass null to clear."),
   schedule_enabled: z.boolean().optional().describe("Pause / resume the scheduler.")
@@ -3632,10 +3719,14 @@ var updateCampaignTool = {
   handler: async (input, ctx) => {
     const body = {
       ...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.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 } : {},
       ...input.policy_set_id !== void 0 ? { policy_set_id: input.policy_set_id } : {},
-      ...input.schedule_enabled !== void 0 ? { schedule_enabled: input.schedule_enabled } : {}
+      ...input.schedule_enabled !== void 0 ? { schedule_enabled: input.schedule_enabled } : {},
+      ...pickCampaignConfigBody(input)
     };
     const result = await ctx.api.updateCampaign(input.campaign_id, body);
     if (result.isErr()) return err(mapApiError(result.error));
@@ -3643,17 +3734,25 @@ var updateCampaignTool = {
   }
 };
 var CreateCustomRuleInputShape = {
-  name: z.string().min(1).max(200).describe("Display name."),
-  tag_slug: z.string().max(100).optional().describe("Tag slug to assign on match. Empty = create-only (advanced)."),
-  rule_type: z.string().max(50).describe("Rule engine: regex | substring | iab_category | etc. (API validates)."),
-  config: z.record(z.unknown()).describe("Rule-type-specific configuration object. Shape depends on rule_type."),
+  name: z.string().min(1).max(200).describe(
+    "Display name. For non-LLM rules this also becomes the `display_name` of the auto-registered tag definition (see `tag_slug`)."
+  ),
+  tag_slug: z.string().max(100).optional().describe(
+    "Tag slug to assign on match. Empty = create-only (advanced). The API auto-registers a custom tag definition for this slug with `display_name = name`. **MUST NOT collide with a built-in system tag slug** (see `list_tags` where `is_system=true`); colliding requests return 422 with code `checking.system_slug_reserved`. For `rule_type='llm'` use `config.tags` keys instead and leave `tag_slug` empty."
+  ),
+  rule_type: z.string().max(50).describe(
+    "Rule engine. One of: `stopword_content`, `stopword_url`, `regexp_content`, `regexp_url`, `blacklist_domain`, `combo`, `llm`. The API validates."
+  ),
+  config: z.record(z.unknown()).describe(
+    "Rule-type-specific configuration object. Shape depends on `rule_type`. For `rule_type='llm'` the shape is `{ prompt: string, tags: { <tag_slug>: <description>, ... } }`; each key in `config.tags` is auto-registered as a custom tag definition AND must not collide with a system slug (same 422 contract as `tag_slug`)."
+  ),
   target: z.string().max(30).optional().describe(
     "Where to apply the rule (e.g. 'page' for landing HTML). Default: page. See API docs for the full set of valid values."
   )
 };
 var createCustomRuleTool = {
   name: "create_custom_rule",
-  description: "Define a custom tag-detection rule (regex / substring / category). Matches will tag every future scan; existing scans are untouched until you call `recheck_scans`.",
+  description: "Define a custom tag-detection rule. The API auto-registers a tag definition for each slug the rule emits (`tag_slug` for non-LLM rules; `config.tags` keys for `rule_type='llm'`); slugs that collide with a built-in system tag are rejected with HTTP 422 / code `checking.system_slug_reserved`. Matches tag every future scan; existing scans are untouched until you call `recheck_scans`.",
   annotations: {
     title: "Create Custom Rule",
     readOnlyHint: false,
@@ -3735,8 +3834,12 @@ var listCustomRulesTool = {
   }
 };
 var TestCustomRuleInputShape = {
-  rule_type: z.string().max(50).describe("Rule engine type (regex, substring, ...)."),
-  config: z.record(z.unknown()).describe("Rule-type-specific config to test."),
+  rule_type: z.string().max(50).describe(
+    "Rule engine type. One of: `stopword_content`, `stopword_url`, `regexp_content`, `regexp_url`, `blacklist_domain`, `combo`, `llm`."
+  ),
+  config: z.record(z.unknown()).describe(
+    "Rule-type-specific config to test. Same shape as `create_custom_rule`'s `config`. NOTE: `test_custom_rule` evaluates the rule against a scan WITHOUT persisting it, so slug-collision validation does NOT run here \u2014 verify slugs against `list_tags` (`is_system=true`) before promoting to `create_custom_rule`."
+  ),
   target: z.string().max(30).describe(
     "Where to apply the rule (e.g. 'page' for landing HTML). See API docs for the full set of valid values."
   ),
@@ -3744,7 +3847,7 @@ var TestCustomRuleInputShape = {
 };
 var testCustomRuleTool = {
   name: "test_custom_rule",
-  description: "Preview-test a rule definition against an existing scan WITHOUT persisting the rule. Returns `matched: bool`, evaluation time, and per-tag-slug details. Use to validate config before `create_custom_rule`.",
+  description: "Preview-test a rule definition against an existing scan WITHOUT persisting the rule. Returns `matched: bool`, evaluation time, and per-tag-slug details. Use to validate config before `create_custom_rule`. NOTE: slug-collision validation does NOT run in preview mode \u2014 verify any `tag_slug` (or LLM `config.tags` keys) against `list_tags` (`is_system=true`) before promoting to `create_custom_rule`, which would otherwise reject the same payload with HTTP 422 / code `checking.system_slug_reserved`.",
   annotations: {
     title: "Test Custom Rule",
     readOnlyHint: true,
@@ -3766,9 +3869,15 @@ var testCustomRuleTool = {
 };
 var UpdateCustomRuleInputShape = {
   rule_id: z.string().uuid().describe("Rule UUID to update."),
-  name: z.string().min(1).max(200).optional().describe("New display name."),
-  tag_slug: z.string().max(100).optional().describe("New tag slug to assign on match."),
-  config: z.record(z.unknown()).optional().describe("New rule-type-specific config object."),
+  name: z.string().min(1).max(200).optional().describe(
+    "New display name. For non-LLM rules this also becomes the new `display_name` of the auto-registered tag definition."
+  ),
+  tag_slug: z.string().max(100).optional().describe(
+    "New tag slug to assign on match. **MUST NOT collide with a built-in system tag slug** (see `list_tags` where `is_system=true`); colliding requests return 422 with code `checking.system_slug_reserved`. Re-registering an existing custom slug refreshes its tag definition's `display_name` / `description`."
+  ),
+  config: z.record(z.unknown()).optional().describe(
+    "New rule-type-specific config object. For `rule_type='llm'` the keys of `config.tags` are auto-registered as tag definitions; any key that collides with a system slug returns the same 422 contract."
+  ),
   target: z.string().max(30).optional().describe(
     "Where to apply the rule (e.g. 'page' for landing HTML). See API docs for the full set of valid values."
   ),
@@ -3776,7 +3885,7 @@ var UpdateCustomRuleInputShape = {
 };
 var updateCustomRuleTool = {
   name: "update_custom_rule",
-  description: "Update a custom tag-detection rule. Only supplied fields are sent. To toggle activation, pass `is_active`. Existing tagged scans are NOT re-evaluated \u2014 call `recheck_scans` for that. (Rule engine `rule_type` cannot be changed after creation; create a new rule instead.)",
+  description: "Update a custom tag-detection rule. Only supplied fields are sent. Changing `tag_slug` (or `config.tags` keys for `rule_type='llm'`) onto a built-in system slug returns HTTP 422 / code `checking.system_slug_reserved`. To toggle activation, pass `is_active`. Existing tagged scans are NOT re-evaluated \u2014 call `recheck_scans` for that. (Rule engine `rule_type` cannot be changed after creation; create a new rule instead.)",
   annotations: {
     title: "Update Custom Rule",
     readOnlyHint: false,
@@ -3990,7 +4099,7 @@ var updateCustomTaxonomyTool = {
 var ListEmulatorsInputShape = {};
 var listEmulatorsTool = {
   name: "list_emulators",
-  description: "List every device/OS emulator profile available for scans (id, display name, category, browser). Use the `id` as `emulator_id` in `create_scan` / `create_campaign`.",
+  description: "List every device/OS emulator profile available for scans (id, display name, category, browser). For `create_scan`, use the `id` as `emulator_id`. For `create_campaign` / `update_campaign`, use the `category` in `emulator_categories` or the `id` in `emulator_specific_ids`.",
   annotations: {
     title: "List Emulators",
     readOnlyHint: true,
@@ -4395,7 +4504,7 @@ var ListRunScansInputShape = {
 };
 var listRunScansTool = {
   name: "list_run_scans",
-  description: "List the tile-scan items produced by one run (status, country, offer URL, screenshot, elapsed ms, error). For full scan details (input URL, labels, classification, redirect chain) fetch a specific scan via `get_scan`.",
+  description: "List the tile-scan items produced by one run (status, country, offer URL, absolute screenshot URL, report_url + public_report_url deep-links, elapsed ms, error). Link users to a scan with the returned `report_url` (auth dashboard) or `public_report_url` (shareable) \u2014 never hand-build URLs. For full scan details (input URL, labels, classification, redirect chain) fetch a specific scan via `get_scan`.",
   annotations: {
     title: "List Run Scans",
     readOnlyHint: true,
@@ -4433,11 +4542,20 @@ var cancelScanTool = {
     return ok(result.value);
   }
 };
+var scanProxyField = z.object({
+  proxy_type: z.enum(["residential", "mobile"]).optional().describe("Proxy network type. Default: residential."),
+  region: z.string().optional().describe("Proxy region/state targeting."),
+  city: z.string().optional().describe("Proxy city targeting."),
+  isp: z.string().optional().describe("Proxy ISP targeting.")
+}).optional().describe("Optional proxy geo targeting for the crawl. Omit to use the org default.");
+
+// 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."),
   ad_tag: z.string().optional().describe("Raw ad-tag HTML/JS. EITHER `url` OR `ad_tag` is required."),
   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."),
+  proxy: scanProxyField,
   labels: z.record(z.string()).optional().describe("Arbitrary metadata copied onto every created scan.")
 };
 var createBulkScansTool = {
@@ -4457,6 +4575,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.proxy !== void 0 ? { proxy: input.proxy } : {},
       ...input.labels !== void 0 ? { labels: input.labels } : {}
     };
     const result = await ctx.api.createBulkScans(body);
@@ -4469,6 +4588,7 @@ var CreateScanInputShape = {
   ad_tag: z.string().optional().describe("Raw HTML/JS ad tag (script, iframe, image). EITHER `url` OR `ad_tag` is required."),
   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.")
@@ -4490,6 +4610,7 @@ 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.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 } : {}
@@ -4504,7 +4625,7 @@ var GetScanInputShape = {
 };
 var getScanTool = {
   name: "get_scan",
-  description: "Get full detail for one scan by UUID: status, offer URL, screenshot URL, timing, labels, and the parent campaign if any.",
+  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.",
   annotations: {
     title: "Get Scan",
     readOnlyHint: true,
@@ -4622,7 +4743,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.",
+  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.",
   annotations: {
     title: "List Scans",
     readOnlyHint: true,
@@ -5042,7 +5163,12 @@ var testWebhookTool = {
 var UpdateWebhookInputShape = {
   webhook_id: z.string().uuid().describe("Webhook UUID."),
   url: z.string().url().optional().describe("New endpoint URL."),
+  description: z.string().max(256).optional().describe("New human-readable label."),
   event_types: z.array(z.string()).max(50).optional().describe("Replace the subscribed-event-types list."),
+  campaign_ids: z.array(z.string().uuid()).optional().describe("Restrict deliveries to these campaign UUIDs (replaces the current set)."),
+  clear_campaign_ids: z.boolean().optional().describe(
+    "Set true to remove the campaign restriction so the webhook fires for all campaigns."
+  ),
   is_active: z.boolean().optional().describe("Enable / disable delivery.")
 };
 var updateWebhookTool = {
@@ -5059,7 +5185,10 @@ var updateWebhookTool = {
   handler: async (input, ctx) => {
     const body = {
       ...input.url !== void 0 ? { url: input.url } : {},
+      ...input.description !== void 0 ? { description: input.description } : {},
       ...input.event_types !== void 0 ? { event_types: input.event_types } : {},
+      ...input.campaign_ids !== void 0 ? { campaign_ids: input.campaign_ids } : {},
+      ...input.clear_campaign_ids !== void 0 ? { clear_campaign_ids: input.clear_campaign_ids } : {},
       ...input.is_active !== void 0 ? { is_active: input.is_active } : {}
     };
     const result = await ctx.api.updateWebhook(input.webhook_id, body);
@@ -5246,6 +5375,6 @@ function formatToolError(error) {
   }
 }
 
-export { BearerToken, createHttpApiGateway, createPinoLogger, declareEmptyResourcesAndPrompts, newRequestId, wireToolsIntoMcpServer };
-//# sourceMappingURL=chunk-W7TPFRJB.js.map
-//# sourceMappingURL=chunk-W7TPFRJB.js.map
+export { BearerToken, SERVER_INSTRUCTIONS, createHttpApiGateway, createPinoLogger, declareEmptyResourcesAndPrompts, newRequestId, wireToolsIntoMcpServer };
+//# sourceMappingURL=chunk-6FT6HKOB.js.map
+//# sourceMappingURL=chunk-6FT6HKOB.js.map