zuckerbot-mcp 0.4.0 → 0.4.2

package/dist/tools.js

@@ -130,14 +130,14 @@ function buildQuickstartPayload(client) {
             {
                 step: 4,
                 tool: "zuckerbot_create_campaign",
-                description: "Full campaign strategy with audience tiers",
+                description: "Create a reviewed launch-ready campaign draft",
                 requires_key: true,
                 flow: "quick_launch",
             },
             {
                 step: 5,
                 tool: "zuckerbot_launch_campaign",
-                description: "Go live on Meta",
+                description: "Launch the reviewed legacy draft on Meta",
                 requires_key: true,
                 flow: "quick_launch",
             },
@@ -269,12 +269,12 @@ const businessContextTypeSchema = z
 // always available.
 function registerCreativeGenerationTools(server, client) {
     // ── Generate Static Ad ──────────────────────────────────────────
-    server.tool("zuckerbot_generate_static_ad", "Generate a brand-aware 1080×1080 static ad image using the Ad Compositor. Automatically injects brand context (logo, colors, brand name, value props, social proof) from the business profile when business_id is provided — no need to pass brand data manually. Templates: stat_hook (statistic + supporting copy), pain_headline (bold headline + benefit bullets), testimonial (customer quote + portrait), feature_showcase (product + benefits). Returns a public image URL and QA scores. Present the image to the customer for approval; to generate more variants, call again with different parameters.", {
+    server.tool("zuckerbot_generate_static_ad", "Generate a brand-aware 1080×1080 static ad image. Automatically injects brand context (logo, colors, brand name, value props, social proof) from the business profile when business_id is provided — no need to pass brand data manually. Templates: stat_hook (statistic + supporting copy), pain_headline (bold headline + benefit bullets), testimonial (customer quote + portrait), feature_showcase (product + benefits). Returns a public image URL and QA scores. Present the image to the customer for approval; to generate more variants, call again with different parameters.", {
         business_id: z.string().optional().describe("Business ID for automatic brand context injection (logo, colors, CTA, testimonials)"),
         session_id: z.string().optional().describe("Architect session ID — when provided, the generated asset is linked to this campaign session"),
         template: z
             .enum(["stat_hook", "pain_headline", "testimonial", "feature_showcase"])
-            .describe("Compositor template"),
+            .describe("Ad template"),
         headline: z.string().optional().describe("Primary headline (required for stat_hook, pain_headline, feature_showcase)"),
         subtext: z.string().optional().describe("Subtext below headline (stat_hook only)"),
         body: z.string().optional().describe("Body copy (stat_hook only)"),
@@ -301,8 +301,8 @@ function registerCreativeGenerationTools(server, client) {
         }
     });
     // ── Generate Video Ad ───────────────────────────────────────────
-    server.tool("zuckerbot_generate_video_ad", "Generate a video ad by dispatching to the Ad Factory pipeline (Claude scripting → Sora/FAL video → Shotstack overlay → FFmpeg captions → Cloudinary upload). ASYNC operation: returns a job_id immediately. Poll with zuckerbot_get_video_ad_status every 30 seconds for completion. Brand context is loaded server-side. Typical generation time: 5-15 minutes. Note: Sora-generated video ads may face Meta ad review scrutiny — rejection tracking is built in.", {
-        business_id: z.string().describe("Business ID (required for Ad Factory routing)"),
+    server.tool("zuckerbot_generate_video_ad", "Generate a video ad through ZuckerBot's video generation pipeline (AI scripting → AI video → captioned overlay → hosted upload). ASYNC operation: returns a job_id immediately. Poll with zuckerbot_get_video_ad_status every 30 seconds for completion. Brand context is loaded server-side. Typical generation time: 5-15 minutes. Note: AI-generated video ads may face Meta ad review scrutiny — rejection tracking is built in.", {
+        business_id: z.string().describe("Business ID (required for creative routing)"),
         focus: z.string().describe("Product/feature focus for the ad (e.g., 'missed_calls', 'quoting', 'scheduling')"),
         market: z.string().default("AU").describe("Target market code (AU, US, UK, NZ)"),
         ad_account_id: z.string().optional().describe("Meta ad account ID (auto-resolved if omitted)"),
@@ -357,8 +357,8 @@ function registerCreativeGenerationTools(server, client) {
             return formatError(err);
         }
     });
-    // ── Request Creative (Ad Factory dispatch) ──────────────────────
-    server.tool("zuckerbot_request_creative", "Dispatch a creative production request for an approved intelligence campaign. If an Ad Factory webhook is configured on the business, ZuckerBot generates full video scripts via Claude and fires the Ad Factory payload. Use this when you want ZuckerBot to handle creative production end-to-end rather than uploading your own assets.", {
+    // ── Request Creative (creative-pipeline dispatch) ───────────────
+    server.tool("zuckerbot_request_creative", "Dispatch a creative production request for an approved intelligence campaign. If a creative-production webhook is configured on the business, ZuckerBot generates full video scripts and fires the production payload. Use this when you want ZuckerBot to handle creative production end-to-end rather than uploading your own assets.", {
         campaign_id: z.string().describe("Intelligence campaign ID"),
         creative_handoff: creativeHandoffSchema.describe("Optional creative handoff configuration"),
     }, async ({ campaign_id, creative_handoff }) => {
@@ -367,14 +367,14 @@ function registerCreativeGenerationTools(server, client) {
             if (creative_handoff)
                 body.creative_handoff = creative_handoff;
             const result = await client.post(`/campaigns/${campaign_id}/request-creative`, body);
-            return formatResult(appendHint(result, "Creative request dispatched. Monitor progress with zuckerbot_get_creative_status. Once all_complete is true, call zuckerbot_activate_campaign to go live."));
+            return formatResult(appendHint(result, "Creative request dispatched for planning/review. Monitor progress with zuckerbot_get_creative_status. Multi-tier activation is temporarily disabled; use a legacy campaign draft for a live launch."));
         }
         catch (err) {
             return formatError(err);
         }
     });
     // ── Generate Creatives ──────────────────────────────────────────
-    server.tool("zuckerbot_generate_creatives", "Generate standalone ad creative variants (images or video) using AI image models (Seedream/Imagen) or video generation (Kling). Works independently of campaign creation — useful for quick mockups, creative testing, or building assets before attaching them to a campaign. If the description mentions video, reels, UGC, or TikTok, the tool auto-routes to the Kling video model.", {
+    server.tool("zuckerbot_generate_creatives", "Generate standalone ad creative variants (images or video) using AI image and video models. Works independently of campaign creation — useful for quick mockups, creative testing, or building assets before attaching them to a campaign. If the description mentions video, reels, UGC, or TikTok, the tool auto-routes to the video model.", {
         business_id: z.string().optional()
             .describe("Optional business ID. When provided, brand context (name, tagline, value props, audience) is automatically injected into the generation request for more on-brand results."),
         business_name: z.string().describe("Business name"),
@@ -389,7 +389,7 @@ function registerCreativeGenerationTools(server, client) {
         model: z
             .enum(["auto", "seedream", "imagen", "kling"])
             .optional()
-            .describe("Model selection. auto/seedream/imagen are image paths, kling is video path. Optional; inferred when omitted."),
+            .describe("Model selection. auto/seedream/imagen are image paths, kling is the video path. Optional; inferred from the description when omitted."),
         media_type: z
             .enum(["image", "video"])
             .optional()
@@ -433,26 +433,53 @@ export function registerTools(server, client) {
     registerQuickstartTool(server, client);
     registerBillingStatusTool(server, client);
     // ── 0a. Account Audit ───────────────────────────────────────────
-    server.tool("zuckerbot_audit_account", "Run a full audit of the connected Meta ad account: wasted spend detection, creative fatigue, opportunity score (0-100), projected CPL improvement, and prioritised action items. Read-only and available on every tier — the recommended FIRST call for any new account or when a user asks 'how are my ads doing?'.", {
+    server.tool("zuckerbot_audit_account", "Run a full audit of the connected Meta ad account: wasted spend detection, creative fatigue, a complete-account opportunity score (0-100 when all inputs return), and prioritised action items. Saves a shareable web report when the API key resolves to one saved business. Read-only and available on every tier — the recommended FIRST call for any new account or when a user asks 'how are my ads doing?'.", {
         meta_ad_account_id: z.string().optional().describe("Meta ad account ID to audit (format: act_XXXXX). Defaults to the connected account."),
         company_name: z.string().optional().describe("Company name used in the audit narrative. Defaults to the connected business name."),
     }, async ({ meta_ad_account_id, company_name }) => {
         try {
             client.requireAuth();
-            const body = {};
+            // Ask the API to persist when one business is resolvable, but keep the
+            // audit itself available when setup/selection is still incomplete.
+            // This stays one metered request and one Meta audit in both cases.
+            const body = {
+                save_report: true,
+                save_report_if_available: true,
+            };
             if (meta_ad_account_id)
                 body.meta_ad_account_id = meta_ad_account_id;
             if (company_name)
                 body.company_name = company_name;
             const result = await client.post("/audit", body);
-            return formatResult(appendHint(result, "Audit complete. Present opportunityScore, wastedSpendEstCents, and audit.rawInsights.action_items to the user, then act on the findings: zuckerbot_get_performance to drill into a specific campaign, zuckerbot_pause_campaign to stop wasted spend, or zuckerbot_creative_analysis to diagnose fatigued creatives."));
+            const record = asRecord(result);
+            const audit = asRecord(record?.audit);
+            const raw = asRecord(audit?.rawInsights);
+            const dataCompleteness = asRecord(raw?.data_completeness);
+            // Raw Meta insight rows drown the agent's context; the summarised
+            // findings above them carry everything the report presents.
+            if (raw && "campaign_rows" in raw)
+                delete raw.campaign_rows;
+            const reportUrl = typeof record?.report_url === "string" ? `https://zuckerbot.ai${record.report_url}` : null;
+            const partialDataHint = raw?.data_truncated === true
+                ? " NOTE: Meta returned incomplete data. Check audit.rawInsights.data_completeness and do not present opportunityScore or exact spend/fatigue ratios as complete-account measures."
+                : "";
+            const scoreHint = typeof audit?.opportunityScore !== "number"
+                ? " NOTE: No opportunity score is available for this result. Do not present or infer a numeric account rating."
+                : "";
+            const currencyHint = dataCompleteness?.account_currency_available === false
+                ? " NOTE: Meta did not return the account currency. Describe money as account-currency units; do not label it AUD or invent another currency code."
+                : "";
+            const reportHint = reportUrl
+                ? ` A shareable web report was saved — give the user this link: ${reportUrl}`
+                : " No shareable report was saved because this API key does not resolve to one saved business.";
+            return formatResult(appendHint(result, `Audit complete.${reportHint}${partialDataHint}${scoreHint}${currencyHint} Present complete observed findings and audit.rawInsights.action_items to the user, then act on them: zuckerbot_get_performance to drill into a specific campaign, zuckerbot_pause_campaign to stop wasted spend, or zuckerbot_creative_analysis to diagnose fatigued creatives.`));
         }
         catch (err) {
             return formatError(err);
         }
     });
     // ── 0b. Redeem Lifetime Licence ─────────────────────────────────
-    server.tool("zuckerbot_redeem_license", "Redeem a ZuckerBot lifetime licence code (format ZB-XXXXX-XXXXX-XXXXX) purchased on Dealify or AppSumo. Codes stack on one account: 1 code = Lifetime Tier 1 (1 ad account, 2,500 calls/mo), 2 codes = Tier 2 (3 accounts, 10K calls/mo), 3 codes = Tier 3 (10 accounts, 30K calls/mo). Redeeming upgrades ALL of the account's API keys to the new tier immediately.", {
+    server.tool("zuckerbot_redeem_license", "Redeem a ZuckerBot lifetime licence code (format ZB-XXXXX-XXXXX-XXXXX) purchased on Dealify or AppSumo. Each code activates the plan it was purchased for: Tier 1 (1 ad account, 2,500 calls/mo), Tier 2 (3 accounts, 10K calls/mo) or Tier 3 (10 accounts, 30K calls/mo). Codes also stack additively on one account up to Tier 3 — e.g. two Tier 1 codes = Tier 2. Redeeming upgrades ALL of the account's API keys to the new tier immediately.", {
         code: z.string().describe("Lifetime licence code in the format ZB-XXXXX-XXXXX-XXXXX"),
     }, async ({ code }) => {
         try {
@@ -462,7 +489,7 @@ export function registerTools(server, client) {
             const mintedKey = asRecord(record?.api_key);
             const hint = mintedKey
                 ? "IMPORTANT: a new API key was minted during redemption. Show the full api_key.key value to the user IMMEDIATELY and tell them to store it securely — it will NEVER be shown again. Then follow the next_steps in the response."
-                : "Licence redeemed — all of this account's API keys are upgraded to the new tier. Compare codes_redeemed with max_stack: stacking another code unlocks the next tier. Run zuckerbot_audit_account to put the new limits to work.";
+                : "Licence redeemed — all of this account's API keys are upgraded to the new tier. If the tier is below Lifetime Tier 3, stacking another code raises it. Run zuckerbot_audit_account to put the new limits to work.";
             return formatResult(appendHint(result, hint));
         }
         catch (err) {
@@ -583,7 +610,7 @@ export function registerTools(server, client) {
         }
     });
     // ── 3. Generate Campaign Brief ─────────────────────────────────
-    server.tool("zuckerbot_generate_campaign_brief", "Generate a detailed creative brief from an approved campaign structure. SAFE — pure function, no Meta API calls, no money spent. Automatically pulls brand context and historical creative patterns (or uses brand context alone for cold-start accounts). Returns per-slot creative directions: for static ads, specific compositor template + headline/body/CTA + hero image prompt; for video ads, hook concept + voiceover direction + visual style. After brief is generated, present it to the customer, then call zuckerbot_generate_static_ad / zuckerbot_generate_video_ad for each slot.", {
+    server.tool("zuckerbot_generate_campaign_brief", "Generate a detailed creative brief from an approved campaign structure. SAFE — pure function, no Meta API calls, no money spent. Automatically pulls brand context and historical creative patterns (or uses brand context alone for cold-start accounts). Returns per-slot creative directions: for static ads, specific ad template + headline/body/CTA + hero image prompt; for video ads, hook concept + voiceover direction + visual style. After brief is generated, present it to the customer, then call zuckerbot_generate_static_ad / zuckerbot_generate_video_ad for each slot.", {
         business_id: z.string().optional().describe("Business ID (auto-resolved from API key if omitted)"),
         session_id: z.string().optional().describe("Architect session ID from zuckerbot_recommend_campaign_structure"),
         approved_structure: z.string().optional().describe("JSON string of approved campaign structure (if no session_id)"),
@@ -608,15 +635,15 @@ export function registerTools(server, client) {
         }
     });
     // ── 7. Create Full Campaign ─────────────────────────────────────
-    server.tool("zuckerbot_create_full_campaign", "Build a complete Meta campaign from an approved Campaign Architect session. IMPORTANT: dry_run defaults to TRUE. When dry_run=true, returns the exact campaign structure that WOULD be created without calling Meta — safe, free, no side effects. Present this to the customer first. Only set dry_run=false after explicit customer approval. When dry_run=false, creates live Meta objects (campaign + ad sets + ads) in PAUSED state. Videos from ad_factory_jobs get linked for rejection tracking automatically.", {
+    server.tool("zuckerbot_create_full_campaign", "Build a complete PAUSED Meta campaign from an approved Campaign Architect session. IMPORTANT: dry_run defaults to TRUE. When dry_run=true, returns the exact campaign structure that WOULD be created without calling Meta — safe, free, no side effects. Present this to the customer first. Only set dry_run=false after explicit customer approval. When dry_run=false, creates Meta objects in PAUSED state for review; Architect auto-activation is temporarily disabled. Generated videos get linked for rejection tracking automatically.", {
         session_id: z.string().describe("Campaign Architect session ID with approved strategy and creatives"),
         dry_run: z.boolean().default(true)
             .describe("DEFAULT TRUE. Set to false ONLY after customer has approved the dry-run preview. Live mode creates real Meta objects."),
         meta_access_token: z.string().optional().describe("Meta access token override (live mode only)"),
         meta_ad_account_id: z.string().optional().describe("Meta ad account ID override (live mode only)"),
         meta_page_id: z.string().optional().describe("Facebook Page ID override (live mode only)"),
-        activate: z.boolean().default(false)
-            .describe("If true AND dry_run=false, activate immediately after creation. Default false — stays PAUSED for customer approval."),
+        activate: z.literal(false).default(false)
+            .describe("Must remain false. Architect auto-activation is temporarily disabled; live mode creates PAUSED Meta objects only."),
     }, async ({ session_id, dry_run, meta_access_token, meta_ad_account_id, meta_page_id, activate }) => {
         try {
             client.requireAuth();
@@ -632,9 +659,7 @@ export function registerTools(server, client) {
             const isDryRun = record.dry_run === true;
             const hint = isDryRun
                 ? "DRY RUN — no Meta objects were created. Present the would_create structure to the customer. If they approve, call again with dry_run=false to create live Meta objects."
-                : activate
-                    ? "Campaign built and activated on Meta. Monitor performance with zuckerbot_get_performance. Videos from ad_factory_jobs are linked for rejection tracking."
-                    : "Campaign built in PAUSED state on Meta. Present the meta_structure to the customer, then resume the campaign on Meta only after approval. Videos linked for rejection tracking.";
+                : "Campaign built in PAUSED state on Meta for review. Architect auto-activation and campaign resume are temporarily disabled; use a reviewed legacy draft with zuckerbot_launch_campaign for the supported live path. Videos linked for rejection tracking.";
             return formatResult(appendHint(result, hint));
         }
         catch (err) {
@@ -657,14 +682,14 @@ export function registerTools(server, client) {
                 url,
                 ad_count,
             });
-            return formatResult(appendHint(result, "Preview generated. Call zuckerbot_create_campaign with the same URL to build a full intelligence strategy with audience tiers and budget guidance."));
+            return formatResult(appendHint(result, "Preview generated. Call zuckerbot_create_campaign with the same URL; it defaults to the reviewed legacy draft path that can be launched safely."));
         }
         catch (err) {
             return formatError(err);
         }
     });
     // ── 7. Create Campaign ──────────────────────────────────────────
-    server.tool("zuckerbot_create_campaign", "Create a new campaign draft for a business. In intelligence mode (preferred when a business_id is available) this returns context-aware audience tiers, creative angles, budget guidance, projected CPL, and phased next steps. Does NOT spend money or create anything on Meta — it's purely a planning step. Use zuckerbot_launch_campaign to go live after strategy approval.", {
+    server.tool("zuckerbot_create_campaign", "Create a new campaign draft for a business. Defaults to legacy mode, the only launch-ready path during Dealify hardening. Intelligence mode remains available for planning only and cannot be activated. This tool does not spend money or create anything on Meta; review the draft, then use zuckerbot_launch_campaign.", {
         url: z.string().describe("Business website URL"),
         business_id: z.string().optional().describe("Existing ZuckerBot business ID to anchor intelligence mode"),
         architect_session_id: z.string().optional()
@@ -682,8 +707,8 @@ export function registerTools(server, client) {
             .describe("Daily budget in cents (e.g., 2000 = $20/day)"),
         mode: z
             .enum(["auto", "legacy", "intelligence"])
-            .optional()
-            .describe("Campaign planning mode. auto prefers intelligence when a business can be resolved"),
+            .default("legacy")
+            .describe("Campaign planning mode. Default legacy is the only launch-ready path. auto/intelligence are planning-only while multi-tier activation is disabled."),
         objective: z
             .enum(["leads", "traffic", "conversions", "awareness"])
             .optional()
@@ -713,8 +738,7 @@ export function registerTools(server, client) {
                 body.location = location;
             if (budget_daily_cents !== undefined)
                 body.budget_daily_cents = budget_daily_cents;
-            if (mode)
-                body.mode = mode;
+            body.mode = mode ?? "legacy";
             if (objective)
                 body.objective = objective;
             if (lead_destination)
@@ -726,7 +750,9 @@ export function registerTools(server, client) {
             if (creative_handoff)
                 body.creative_handoff = creative_handoff;
             const result = await client.post("/campaigns/create", body);
-            return formatResult(appendHint(result, "Campaign draft created. For intelligence campaigns: call zuckerbot_approve_campaign_strategy to confirm audience tiers and angles, then zuckerbot_request_creative or zuckerbot_upload_creative to attach creatives before launch."));
+            return formatResult(appendHint(result, mode === "legacy"
+                ? "Launch-ready legacy draft created. Review it, confirm Meta credentials and budget, then call zuckerbot_launch_campaign."
+                : "Planning-only intelligence draft created. Multi-tier activation is temporarily disabled; create a legacy-mode draft when the user is ready to launch."));
         }
         catch (err) {
             return formatError(err);
@@ -789,7 +815,7 @@ export function registerTools(server, client) {
     }, async ({ campaign_id }) => {
         try {
             const result = await client.get(`/campaigns/${campaign_id}`);
-            return formatResult(appendHint(result, "Inspect creative_status and workflow state. Next steps depend on campaign_version: intelligence campaigns → approve strategy → upload creatives → activate. Legacy campaigns → launch directly."));
+            return formatResult(appendHint(result, "Inspect creative_status and workflow state. Legacy campaigns can launch directly after review. Intelligence campaigns are planning-only while multi-tier activation is disabled."));
         }
         catch (err) {
             return formatError(err);
@@ -807,13 +833,13 @@ export function registerTools(server, client) {
             if (angle_names?.length)
                 body.angle_names = angle_names;
             const result = await client.post(`/campaigns/${campaign_id}/approve-strategy`, body);
-            return formatResult(appendHint(result, "Strategy approved. Call zuckerbot_request_creative to dispatch Ad Factory, or zuckerbot_upload_creative if you already have assets ready. Alternatively, use the Campaign Architect flow: analyse_account_history → recommend_campaign_structure → generate_campaign_brief."));
+            return formatResult(appendHint(result, "Strategy approved. Upload your creative assets with zuckerbot_upload_creative, or use the Campaign Architect flow: analyse_account_history → recommend_campaign_structure → generate_campaign_brief."));
         }
         catch (err) {
             return formatError(err);
         }
     });
-    server.tool("zuckerbot_upload_creative", "Upload finished creative assets (images or videos) to an approved intelligence campaign. ZuckerBot queues the Meta upload and ad-creation jobs asynchronously, then polls until they complete or the polling window expires. Use this when you have your own creative assets ready rather than using Ad Factory.", {
+    server.tool("zuckerbot_upload_creative", "Upload finished creative assets (images or videos) to an approved intelligence campaign. ZuckerBot queues the Meta upload and ad-creation jobs asynchronously, then polls until they complete or the polling window expires. Use this when you have your own creative assets ready.", {
         campaign_id: z.string().describe("Intelligence campaign ID"),
         creatives: z.array(creativeUploadSchema).min(1).describe("Creative assets to attach to the campaign"),
         meta_access_token: z.string().optional().describe("Optional Meta/Facebook access token override"),
@@ -833,7 +859,7 @@ export function registerTools(server, client) {
             const creativeStatus = typeof payload?.creative_status === "string" ? payload.creative_status : null;
             const queuedJobs = Array.isArray(payload?.queued_jobs) ? payload.queued_jobs : [];
             if (creativeStatus !== "uploading" || queuedJobs.length === 0) {
-                return formatResult(appendHint(result, "Creatives uploaded. Call zuckerbot_get_creative_status to check processing status, then zuckerbot_activate_campaign once all_complete is true."));
+                return formatResult(appendHint(result, "Creatives uploaded. Call zuckerbot_get_creative_status to check processing status. Intelligence activation is temporarily disabled; use a reviewed legacy draft for live launch."));
             }
             try {
                 const polled = await pollCreativeStatus(client, campaign_id);
@@ -847,7 +873,7 @@ export function registerTools(server, client) {
                             interval_seconds: CREATIVE_STATUS_POLL_INTERVAL_MS / 1000,
                         },
                         final_status: polled.lastStatus,
-                    }, "All creatives uploaded and processed. Call zuckerbot_activate_campaign to turn on the paused Meta ad sets and go live."));
+                    }, "All creatives uploaded and processed for review. Intelligence activation is temporarily disabled; use a reviewed legacy draft for live launch."));
                 }
                 return formatResult(appendHint({
                     initial_response: payload,
@@ -860,7 +886,7 @@ export function registerTools(server, client) {
                         suggested_tool: "zuckerbot_get_creative_status",
                     },
                     last_status: polled.lastStatus,
-                }, "Uploads still processing. Call zuckerbot_get_creative_status in 15–30 seconds to check progress. Once all_complete is true, call zuckerbot_activate_campaign."));
+                }, "Uploads still processing. Call zuckerbot_get_creative_status in 15–30 seconds to check progress. Completed intelligence creatives remain review-only while activation is disabled."));
             }
             catch (pollError) {
                 return formatResult(appendHint({
@@ -876,40 +902,36 @@ export function registerTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool("zuckerbot_get_creative_status", "Check the asynchronous upload queue for an intelligence campaign to see if Meta ad-creation jobs are complete. Poll this after zuckerbot_upload_creative when the initial response shows creative_status='uploading'. Returns all_complete=true when every queued job has finished and the campaign is ready to activate.", {
+    server.tool("zuckerbot_get_creative_status", "Check the asynchronous upload queue for an intelligence campaign to see if Meta ad-creation jobs are complete. Poll this after zuckerbot_upload_creative when the initial response shows creative_status='uploading'. Returns all_complete=true when every queued job has finished for review; intelligence activation is temporarily disabled.", {
         campaign_id: z.string().describe("Intelligence campaign ID"),
     }, async ({ campaign_id }) => {
         try {
             const result = await client.get(`/campaigns/${campaign_id}/creative-status`);
-            return formatResult(appendHint(result, "If all_complete is true, call zuckerbot_activate_campaign to turn on the paused Meta ad sets. If still uploading, poll again in 15–30 seconds."));
+            return formatResult(appendHint(result, "If still uploading, poll again in 15–30 seconds. Completed intelligence creatives remain available for review, but multi-tier activation is temporarily disabled; use a legacy draft for live launch."));
         }
         catch (err) {
             return formatError(err);
         }
     });
-    server.tool("zuckerbot_activate_campaign", "Activate the ready audience tiers for an intelligence campaign after strategy approval and creative upload. Turns on paused Meta ad sets for each approved tier. Only tiers with valid paused executions and uploaded creatives are activated. Use this as the final step before a campaign goes live on Meta.", {
+    server.tool("zuckerbot_activate_campaign", "Temporarily unavailable during Dealify launch hardening. Intelligence campaigns are planning-only; create a legacy-mode draft and use zuckerbot_launch_campaign for the supported live path.", {
         campaign_id: z.string().describe("Intelligence campaign ID"),
         tier_names: z.array(z.string()).optional().describe("Optional subset of approved tiers to activate"),
         meta_access_token: z.string().optional().describe("Optional Meta/Facebook access token override"),
         meta_ad_account_id: z.string().optional().describe("Optional Meta ad account ID override (format: act_XXXXX)"),
         meta_page_id: z.string().optional().describe("Optional Facebook Page ID override"),
     }, async ({ campaign_id, tier_names, meta_access_token, meta_ad_account_id, meta_page_id }) => {
-        try {
-            const body = {};
-            if (tier_names?.length)
-                body.tier_names = tier_names;
-            if (meta_access_token)
-                body.meta_access_token = meta_access_token;
-            if (meta_ad_account_id)
-                body.meta_ad_account_id = meta_ad_account_id;
-            if (meta_page_id)
-                body.meta_page_id = meta_page_id;
-            const result = await client.post(`/campaigns/${campaign_id}/activate`, body);
-            return formatResult(appendHint(result, "Campaign activated on Meta. Monitor with zuckerbot_get_performance. If budget needs adjusting, use zuckerbot_pause_campaign to stop spend, or zuckerbot_rebalance_portfolio if this campaign belongs to a portfolio."));
-        }
-        catch (err) {
-            return formatError(err);
-        }
+        void tier_names;
+        void meta_access_token;
+        void meta_ad_account_id;
+        void meta_page_id;
+        return formatResult({
+            error: true,
+            code: "intelligence_activation_temporarily_disabled",
+            message: "Multi-tier activation is temporarily disabled. Create a campaign with mode='legacy', review it, then call zuckerbot_launch_campaign.",
+            campaign_id,
+            supported_create_mode: "legacy",
+            supported_launch_tool: "zuckerbot_launch_campaign",
+        });
     });
     server.tool("zuckerbot_suggest_angles", "Return only the creative angles and audience tiers for a campaign draft — a lightweight alternative to zuckerbot_get_campaign when you need just the strategy summary without the full campaign payload, stored creatives, or tier execution details.", {
         campaign_id: z.string().describe("Campaign ID"),
@@ -976,19 +998,19 @@ export function registerTools(server, client) {
             return formatError(err);
         }
     });
-    // ── 4. Pause / Resume Campaign ─────────────────────────────────
-    server.tool("zuckerbot_pause_campaign", "Pause or resume a running Meta ad campaign. Pausing stops ad delivery and spend immediately — the campaign stays in Meta but goes dark. Resuming restarts delivery without relaunching. Use pause when creative needs refreshing, budget is exhausted, or the user asks to stop spending.", {
+    // ── 4. Pause Campaign ──────────────────────────────────────────
+    server.tool("zuckerbot_pause_campaign", "Pause a running Meta ad campaign. Pausing stops ad delivery and spend immediately while leaving the campaign in Meta. Use this when creative needs refreshing, budget is exhausted, entitlement is withdrawn, or the user asks to stop spending. Resume is temporarily disabled during Dealify launch hardening.", {
         campaign_id: z.string().describe("ZuckerBot campaign ID"),
         action: z
-            .enum(["pause", "resume"])
+            .literal("pause")
             .default("pause")
-            .describe("Whether to pause or resume the campaign"),
+            .describe("Pause the campaign"),
     }, async ({ campaign_id, action }) => {
         try {
             const result = await client.post(`/campaigns/${campaign_id}/pause`, {
                 action,
             });
-            return formatResult(appendHint(result, "Campaign paused/resumed. Call zuckerbot_get_performance to see the current delivery status, or zuckerbot_get_campaign to check the full workflow state."));
+            return formatResult(appendHint(result, "Campaign paused. Call zuckerbot_get_performance to confirm delivery has stopped, or zuckerbot_get_campaign to inspect the full workflow state."));
         }
         catch (err) {
             return formatError(err);
@@ -1036,7 +1058,7 @@ export function registerTools(server, client) {
             if (summary_mode)
                 params.set("summary_mode", "true");
             const result = await client.get(`/creative/analysis?${params.toString()}`);
-            return formatResult(appendHint(result, "Analysis complete. Call zuckerbot_creative_cross_analysis to find winning attribute combinations, rerun with include_ads=true to inspect the best and worst individual ads, or use zuckerbot_generate_briefs to produce new Ad Factory briefs weighted toward the strongest patterns. Feed these insights into zuckerbot_recommend_campaign_structure for data-driven campaign planning."));
+            return formatResult(appendHint(result, "Analysis complete. Call zuckerbot_creative_cross_analysis to find winning attribute combinations, rerun with include_ads=true to inspect the best and worst individual ads, or use zuckerbot_generate_briefs to produce new creative briefs weighted toward the strongest patterns. Feed these insights into zuckerbot_recommend_campaign_structure for data-driven campaign planning."));
         }
         catch (err) {
             return formatError(err);
@@ -1081,13 +1103,13 @@ export function registerTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool("zuckerbot_generate_briefs", "Generate Ad Factory-compatible creative production briefs based on the business's tagged ad-performance patterns. Each brief specifies hook type, visual style, copy tone, CTA, and script guidance weighted toward the top-performing creative attributes. Use after running zuckerbot_creative_analysis to know which patterns to bias toward.", {
+    server.tool("zuckerbot_generate_briefs", "Generate creative production briefs based on the business's tagged ad-performance patterns. Each brief specifies hook type, visual style, copy tone, CTA, and script guidance weighted toward the top-performing creative attributes. Use after running zuckerbot_creative_analysis to know which patterns to bias toward.", {
         business_id: z.string().optional().describe("Optional business ID override"),
         count: z.number().int().min(1).max(10).optional().describe("How many briefs to generate. Defaults to 5."),
         bias: z.string().optional().describe("Optional generation bias, for example performance or exploration"),
         exclude_angles: z.array(z.string()).optional().describe("Optional angles or product focuses to avoid"),
         target_market: z.string().optional().describe("Optional target market override, for example AU or US"),
-        font_preset: z.string().optional().describe("Optional Ad Factory font preset override"),
+        font_preset: z.string().optional().describe("Optional font preset override"),
         metric: z.enum(["cpl", "ctr", "cpc", "frequency"]).optional().describe("Optional ranking metric. Defaults to cpl."),
     }, async ({ business_id, count, bias, exclude_angles, target_market, font_preset, metric }) => {
         try {
@@ -1106,7 +1128,7 @@ export function registerTools(server, client) {
             if (metric)
                 body.metric = metric;
             const result = await client.post("/creative/generate-briefs", body);
-            return formatResult(appendHint(result, "Briefs generated. Pass them to your creative team or Ad Factory for production. Once assets are ready, use zuckerbot_upload_creative to attach them to a campaign, or zuckerbot_generate_creatives to generate AI images/video from these concepts. For automated brief generation tied to a campaign plan, use zuckerbot_generate_campaign_brief."));
+            return formatResult(appendHint(result, "Briefs generated. Pass them to your creative team for production. Once assets are ready, use zuckerbot_upload_creative to attach them to a campaign. For automated brief generation tied to a campaign plan, use zuckerbot_generate_campaign_brief."));
         }
         catch (err) {
             return formatError(err);
@@ -1580,7 +1602,7 @@ export function registerTools(server, client) {
         }
     });
     // ── 22. Create Portfolio ───────────────────────────────────────
-    server.tool("zuckerbot_create_portfolio", "Create a multi-tier audience portfolio for a business from a shared template (e.g., 'Local Services', 'eCommerce') or a custom tier array. Portfolios split the total budget across prospecting, retargeting, and reactivation tiers with per-tier CPA targets. After creating, call zuckerbot_launch_portfolio to launch all tiers on Meta.", {
+    server.tool("zuckerbot_create_portfolio", "Create a planning and monitoring-only multi-tier audience portfolio for a business from a shared template (e.g., 'Local Services', 'eCommerce') or a custom tier array. Portfolios split a proposed total budget across prospecting, retargeting, and reactivation tiers with per-tier CPA targets. Portfolio launch is temporarily disabled during Dealify hardening.", {
         business_id: z.string().optional().describe("Optional business ID override"),
         template_id: z.string().optional().describe("Optional portfolio template ID"),
         template_name: z.string().optional().describe("Optional portfolio template name, such as 'Local Services'"),
@@ -1615,19 +1637,19 @@ export function registerTools(server, client) {
             if (tiers)
                 body.tiers = tiers;
             const result = await client.post("/portfolios/create", body);
-            return formatResult(appendHint(result, "Portfolio created. Call zuckerbot_launch_portfolio with the returned portfolio_id to launch all tiers on Meta, or zuckerbot_get_portfolio to review the tier configuration."));
+            return formatResult(appendHint(result, "Planning portfolio created. Call zuckerbot_get_portfolio to review the tier configuration. Portfolio launch is temporarily disabled; use a reviewed legacy draft for live launch."));
         }
         catch (err) {
             return formatError(err);
         }
     });
     // ── 23. Get Portfolio ─────────────────────────────────────────
-    server.tool("zuckerbot_get_portfolio", "Fetch the configuration and current performance snapshot for an audience portfolio by ID. Returns tier definitions, budget allocations, CPA targets, and live performance data. Use this to inspect a portfolio before launching or rebalancing.", {
+    server.tool("zuckerbot_get_portfolio", "Fetch the configuration and current performance snapshot for an audience portfolio by ID. Returns tier definitions, budget allocations, CPA targets, and any existing performance data. Use this to inspect a portfolio for planning, monitoring, or rebalancing an already-active portfolio.", {
         portfolio_id: z.string().describe("Audience portfolio ID"),
     }, async ({ portfolio_id }) => {
         try {
             const result = await client.get(`/portfolios/${portfolio_id}`);
-            return formatResult(appendHint(result, "Review tier config and performance. To adjust settings, call zuckerbot_update_portfolio. To launch on Meta, call zuckerbot_launch_portfolio. To rebalance active tier budgets, call zuckerbot_rebalance_portfolio."));
+            return formatResult(appendHint(result, "Review tier config and performance. To adjust planning settings, call zuckerbot_update_portfolio. Existing active portfolios can be monitored or rebalanced, but new portfolio launch is temporarily disabled."));
         }
         catch (err) {
             return formatError(err);
@@ -1696,26 +1718,23 @@ export function registerTools(server, client) {
         }
     });
     // ── 27. Launch Portfolio ──────────────────────────────────────
-    server.tool("zuckerbot_launch_portfolio", "Launch all tiers in an audience portfolio on Meta. Creates separate Meta campaigns for each tier (prospecting, retargeting, reactivation) using the portfolio's budget allocations and CPA targets. Stored Meta credentials are auto-resolved. Tiers that lack required data (e.g., retargeting without a pixel, lookalike without enough seed events) are skipped with a reason.", {
+    server.tool("zuckerbot_launch_portfolio", "Temporarily unavailable during Dealify launch hardening. Portfolio planning and monitoring remain available, but new multi-tier launches must not create Meta objects. Create a legacy-mode draft and use zuckerbot_launch_campaign for the supported live path.", {
         portfolio_id: z.string().describe("Audience portfolio ID to launch"),
         meta_access_token: z.string().optional().describe("Optional Meta/Facebook access token override"),
         meta_ad_account_id: z.string().optional().describe("Optional Meta ad account ID override (format: act_XXXXX)"),
         meta_page_id: z.string().optional().describe("Optional Facebook Page ID override"),
     }, async ({ portfolio_id, meta_access_token, meta_ad_account_id, meta_page_id }) => {
-        try {
-            const body = {};
-            if (meta_access_token)
-                body.meta_access_token = meta_access_token;
-            if (meta_ad_account_id)
-                body.meta_ad_account_id = meta_ad_account_id;
-            if (meta_page_id)
-                body.meta_page_id = meta_page_id;
-            const result = await client.post(`/portfolios/${portfolio_id}/launch`, body);
-            return formatResult(appendHint(result, "Portfolio launched. Call zuckerbot_portfolio_performance to monitor tier delivery. Use zuckerbot_rebalance_portfolio weekly to redistribute budgets based on CPA performance."));
-        }
-        catch (err) {
-            return formatError(err);
-        }
+        void meta_access_token;
+        void meta_ad_account_id;
+        void meta_page_id;
+        return formatResult({
+            error: true,
+            code: "portfolio_launch_temporarily_disabled",
+            message: "Portfolio launch is temporarily disabled. Create a campaign with mode='legacy', review it, then call zuckerbot_launch_campaign.",
+            portfolio_id,
+            supported_create_mode: "legacy",
+            supported_launch_tool: "zuckerbot_launch_campaign",
+        });
     });
     // ── 28. Tag Creative ──────────────────────────────────────────
     server.tool("zuckerbot_tag_creative", "Tag Meta ads with creative attributes (hook type, visual style, product focus, CTA type, copy tone, setting) by providing ad metadata and optional asset URLs. ZuckerBot uses Claude vision to analyze the creative and store structured tags. These tags feed the zuckerbot_creative_analysis pipeline. Run this after launching new ads to keep the creative intelligence database current.", {