whale-code 6.4.0

package/dist/server/handlers/local-agent.js

@@ -0,0 +1,118 @@
+// server/handlers/local-agent.ts — Local agent remote execution
+// Routes commands to user's local machine via WebSocket gateway.
+// Pattern: same as kali.ts — external execution environment, handler is a thin proxy.
+import { hasLocalAgent, getAgentInfo, executeOnLocalAgent, executeToolOnLocalAgent, discoverLocalTools, getGatewayStats, } from "../local-agent-gateway.js";
+const VALID_ACTIONS = new Set([
+    "exec", "exec_bg", "status", "tools", "discover", "info", "agents",
+]);
+export async function handleLocalAgent(_sb, args, storeId) {
+    const action = args.action;
+    if (!action) {
+        return { success: false, error: "action is required" };
+    }
+    if (!VALID_ACTIONS.has(action)) {
+        return { success: false, error: `Unknown action: ${action}. Valid: ${[...VALID_ACTIONS].join(", ")}` };
+    }
+    if (!storeId) {
+        return { success: false, error: "store_id is required" };
+    }
+    switch (action) {
+        // Execute a shell command on the local machine
+        case "exec":
+        case "exec_bg": {
+            if (!args.command) {
+                return { success: false, error: "command is required for exec" };
+            }
+            if (!hasLocalAgent(storeId)) {
+                return {
+                    success: false,
+                    error: noAgentMessage(),
+                };
+            }
+            const result = await executeOnLocalAgent(storeId, args.command, {
+                session_id: args.session_id,
+                timeout: Math.min(args.timeout || 30000, 600000),
+                agent_id: args.agent_id,
+            });
+            return { success: result.success, data: result };
+        }
+        // Execute a managed local tool (burp, zap, tshark, etc.)
+        case "tools": {
+            if (!args.tool) {
+                // List available tools
+                if (!hasLocalAgent(storeId)) {
+                    return { success: false, error: noAgentMessage() };
+                }
+                const agents = getAgentInfo(storeId);
+                const allTools = new Set();
+                for (const a of agents) {
+                    for (const t of a.capabilities)
+                        allTools.add(t);
+                }
+                return {
+                    success: true,
+                    data: {
+                        tools: [...allTools],
+                        agents: agents.length,
+                        message: `${allTools.size} local tools available across ${agents.length} agent(s)`,
+                    },
+                };
+            }
+            if (!hasLocalAgent(storeId)) {
+                return { success: false, error: noAgentMessage() };
+            }
+            const result = await executeToolOnLocalAgent(storeId, args.tool, args.tool_args || {}, {
+                timeout: Math.min(args.timeout || 60000, 600000),
+                agent_id: args.agent_id,
+            });
+            return { success: result.success, data: result };
+        }
+        // Trigger tool auto-discovery on the local agent
+        case "discover": {
+            if (!hasLocalAgent(storeId)) {
+                return { success: false, error: noAgentMessage() };
+            }
+            const result = await discoverLocalTools(storeId);
+            return { success: result.success, data: result };
+        }
+        // Get connection status and agent info
+        case "status":
+        case "info": {
+            const connected = hasLocalAgent(storeId);
+            const agents = getAgentInfo(storeId);
+            return {
+                success: true,
+                data: {
+                    connected,
+                    agents,
+                    message: connected
+                        ? `${agents.length} local agent(s) connected`
+                        : "No local agent connected. Install: npx swagmanager-agent",
+                },
+            };
+        }
+        // Admin: list all connected agents (gateway-wide stats)
+        case "agents": {
+            return {
+                success: true,
+                data: getGatewayStats(),
+            };
+        }
+        default:
+            return { success: false, error: `Unknown action: ${action}` };
+    }
+}
+function noAgentMessage() {
+    return [
+        "No local agent connected to this store.",
+        "",
+        "Install and start the local agent:",
+        "  npm install -g swagmanager-mcp",
+        "  swag-agent start --key YOUR_API_KEY",
+        "",
+        "Or run without installing:",
+        "  npx swagmanager-mcp agent --key YOUR_API_KEY",
+        "",
+        "Generate an API key: use the api_keys tool with action 'generate'",
+    ].join("\n");
+}

package/dist/server/handlers/meta-ads.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Meta Ads Handler — campaign/ad set/ad CRUD + publish to Meta Graph API.
+ *
+ * V2 features added:
+ * - Reporting breakdowns (age, gender, placement, device, region)
+ * - Ad preview URLs
+ * - Custom audiences (website, customer list, lookalike)
+ * - Lead forms (instant form creation + lead retrieval)
+ * - Conversion tracking (pixels, custom conversions)
+ * - Ad rules / automation (auto-pause, auto-budget)
+ * - Ad scheduling / dayparting
+ * - Placement control (Feed, Stories, Reels, etc.)
+ * - Frequency capping
+ * - Campaign Budget Optimization (CBO)
+ * - Carousel ads (multi-card)
+ * - Dynamic creative (multi-asset optimization)
+ * - Reach estimation / audience insights
+ *
+ * Lessons baked in from live testing against Meta Marketing API v21:
+ * - Budget lives on ad sets, NOT campaigns (unless CBO is enabled)
+ * - is_adset_budget_sharing_enabled: false required on campaign publish (non-CBO)
+ * - bid_strategy always required on ad set publish (even LOWEST_COST)
+ * - targeting_automation.advantage_audience: 0 required (Advantage+ flag)
+ * - DRAFT status invalid for Meta — always mapped to PAUSED
+ * - special_ad_categories only used at publish time (not a DB column)
+ * - Video URLs uploaded to Meta during publish → video_id
+ * - Image URLs uploaded to Meta during publish → image_hash
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+export declare function handleMetaAds(sb: SupabaseClient, args: Record<string, unknown>, storeId?: string): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+    published?: undefined;
+    count?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    data: any;
+    error?: undefined;
+    published?: undefined;
+    count?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    published: boolean;
+    data: {
+        warning?: unknown;
+        campaign: any;
+        ad_set: any;
+        ad: any;
+        meta_ids: {
+            campaign_id: string;
+            ad_set_id: string;
+            creative_id: string;
+            ad_id: string;
+        };
+        publish_error?: undefined;
+        hint?: undefined;
+    };
+    error?: undefined;
+    count?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    published: boolean;
+    data: {
+        campaign: any;
+        ad_set: any;
+        ad: any;
+        publish_error: string;
+        hint: string;
+    };
+    error?: undefined;
+    count?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    published: boolean;
+    data: {
+        campaign: any;
+        ad_set: any;
+        ad: any;
+        hint: string;
+        publish_error?: undefined;
+    };
+    error?: undefined;
+    count?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    count: number;
+    data: any[];
+    error?: undefined;
+    published?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    data: any;
+    message: string;
+    error?: undefined;
+    published?: undefined;
+    count?: undefined;
+} | {
+    success: boolean;
+    message: string;
+    error?: undefined;
+    data?: undefined;
+    published?: undefined;
+    count?: undefined;
+}>;