@elizaos/agent 2.0.0-alpha.441 → 2.0.0-alpha.501

package/packages/agent/src/services/launchpads/launchpad-engine.js

@@ -0,0 +1,191 @@
+/**
+ * Launchpad playbook engine.
+ *
+ * Iterates a LaunchpadProfile's steps, narrating each one and dispatching
+ * the matching BrowserWorkspaceCommand. The engine assumes a watch-mode
+ * page-browser scope (cursor visible, narration goes into the chat
+ * conversation) and prefers the realistic-* subactions added in
+ * browser-workspace-desktop.ts.
+ *
+ * The engine never auto-signs transactions. The `confirmTx` step pauses
+ * for the user to approve the tx in the steward sheet (or the in-page
+ * wallet popup) and then waits for confirmation evidence. In dryRun mode
+ * the engine stops before clicking submit.
+ */
+import { executeBrowserWorkspaceCommand } from "./../browser-workspace.js";
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_WAIT_TIMEOUT_MS = 8_000;
+const DEFAULT_TX_AWAIT_TIMEOUT_MS = 90_000;
+const STEP_GAP_MS = 350;
+function fieldValue(field, metadata) {
+    switch (field.field) {
+        case "name":
+            return metadata.name;
+        case "symbol":
+            return metadata.symbol;
+        case "description":
+            return metadata.description;
+        case "twitter":
+        case "telegram":
+        case "website":
+            // Optional social links — empty string is fine; the launchpad form
+            // typically treats empty fields as skipped.
+            return "";
+    }
+}
+function defaultNarration(step, profileName) {
+    switch (step.kind) {
+        case "navigate":
+            return `Navigating to ${profileName}`;
+        case "waitFor":
+            return step.selector
+                ? `Waiting for ${step.selector}`
+                : "Waiting for page to settle";
+        case "connectWallet":
+            return `Connecting ${step.chain.toUpperCase()} wallet`;
+        case "fillField":
+            return `Filling ${step.field}`;
+        case "uploadImage":
+            return "Uploading token image";
+        case "click":
+            return step.text
+                ? `Clicking "${step.text}"`
+                : `Clicking ${step.selector ?? "element"}`;
+        case "confirmTx":
+            return "Submitting — please confirm in your wallet";
+        case "awaitTxResult":
+            return "Waiting for transaction confirmation";
+    }
+}
+function commandForStep(step, options) {
+    const id = options.tabId;
+    switch (step.kind) {
+        case "navigate":
+            return { id, subaction: "navigate", url: step.url };
+        case "waitFor":
+            return {
+                id,
+                subaction: "wait",
+                selector: step.selector,
+                text: step.text,
+                timeoutMs: step.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS,
+                state: "visible",
+            };
+        case "connectWallet":
+            return {
+                id,
+                subaction: "realistic-click",
+                selector: step.connectButton,
+            };
+        case "fillField":
+            return {
+                id,
+                subaction: "realistic-fill",
+                selector: step.selector,
+                value: fieldValue(step, options.metadata),
+                replace: true,
+            };
+        case "uploadImage":
+            return {
+                id,
+                subaction: "realistic-upload",
+                selector: step.selector,
+                files: [options.metadata.imageUrl],
+            };
+        case "click":
+            return {
+                id,
+                subaction: "realistic-click",
+                selector: step.selector,
+                text: step.text,
+            };
+        case "confirmTx":
+            // The tx submission click itself is a separate "click" step; this
+            // step is the wait-for-confirmation pause. The engine treats it as
+            // a no-op command — narration runs, dryRun gate fires, then the
+            // followup awaitTxResult step polls.
+            return null;
+        case "awaitTxResult":
+            return {
+                id,
+                subaction: "wait",
+                text: step.explorerUrlPattern,
+                timeoutMs: step.timeoutMs ?? DEFAULT_TX_AWAIT_TIMEOUT_MS,
+                state: "visible",
+            };
+    }
+}
+function isRecoverable(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    // These keywords reflect transient races (element not yet rendered,
+    // network blip, etc). Anything else is treated as fatal.
+    return /not found|timed out|navigation|not visible|stale/i.test(message);
+}
+async function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runStep(step, options, profile) {
+    const command = commandForStep(step, options);
+    if (!command) {
+        return null;
+    }
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+        try {
+            return await executeBrowserWorkspaceCommand(command, options.env);
+        }
+        catch (error) {
+            lastError = error;
+            if (!isRecoverable(error) || attempt === maxRetries) {
+                throw error;
+            }
+            // Light backoff between retries.
+            await delay(400 * (attempt + 1));
+        }
+    }
+    // Should be unreachable; appeases the type system.
+    if (lastError instanceof Error)
+        throw lastError;
+    throw new Error(`Launchpad ${profile.id} step ${step.kind} failed without a captured error.`);
+}
+export async function runLaunchpad(profile, options) {
+    const dryRun = options.dryRun ?? "off";
+    for (let stepIndex = 0; stepIndex < profile.steps.length; stepIndex += 1) {
+        const step = profile.steps[stepIndex];
+        const narration = step.narration ?? defaultNarration(step, profile.displayName);
+        if (dryRun === "stop-before-tx" && step.kind === "confirmTx") {
+            await options.narrate(`[dry-run] Stopped before submitting on ${profile.displayName}.`);
+            return {
+                ok: true,
+                profileId: profile.id,
+                stoppedAtStep: stepIndex,
+                reason: "dry-run stopped before transaction",
+            };
+        }
+        await options.narrate(narration);
+        try {
+            await runStep(step, options, profile);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await options.narrate(`Stopped on step ${stepIndex + 1} (${step.kind}): ${message}`);
+            return {
+                ok: false,
+                profileId: profile.id,
+                stoppedAtStep: stepIndex,
+                reason: message,
+            };
+        }
+        // Small gap between steps so the cursor animation completes and the
+        // page has a tick to react. The realistic-* subactions already animate;
+        // this is a safety margin for sites that mount components after click.
+        await delay(STEP_GAP_MS);
+    }
+    return {
+        ok: true,
+        profileId: profile.id,
+        stoppedAtStep: profile.steps.length - 1,
+        reason: "completed",
+    };
+}

package/packages/agent/src/services/launchpads/launchpad-types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Launchpad playbook engine — types.
+ *
+ * The engine drives a browser-workspace tab through a hand-curated sequence
+ * of steps to launch a token on a specific launchpad (four.meme on BNB,
+ * flap.sh on Solana, etc.). Each step maps to one BrowserWorkspaceCommand
+ * (or a small composition) and emits a status line in chat before running
+ * so the user can watch and follow along.
+ *
+ * Decisions (locked by plan):
+ *   - User confirms each launch transaction in the existing steward
+ *     approval surface — no auto-sign anywhere in the engine.
+ *   - The engine prefers realistic-* subactions so the cursor moves and
+ *     pointer events fire faithfully. See BROWSER_TAB_PRELOAD_SCRIPT.
+ *   - dryRun: "stop-before-tx" lets smoke tests exercise the entire
+ *     pre-launch flow (wallet connect + form fill + image upload + cursor
+ *     overlay) without submitting a real transaction.
+ */
+export type LaunchpadChain = "evm" | "solana";
+export interface LaunchpadTokenMetadata {
+    /** Display name of the token. */
+    name: string;
+    /** Ticker symbol (typically 3–6 chars). */
+    symbol: string;
+    /** Long-form description shown on the launchpad. */
+    description: string;
+    /**
+     * URL to the token image. The engine drops this into the launchpad's
+     * file input via the upload step.
+     */
+    imageUrl: string;
+    /**
+     * Optional theme prompt the metadata generator used (kept for narration:
+     * "Choosing token name: $WAGMI — theme: cozy DeFi cat").
+     */
+    theme?: string;
+}
+export type LaunchpadField = "name" | "symbol" | "description" | "twitter" | "telegram" | "website";
+export type LaunchpadStep = {
+    kind: "navigate";
+    url: string;
+    narration?: string;
+} | {
+    kind: "waitFor";
+    selector?: string;
+    text?: string;
+    timeoutMs?: number;
+    narration?: string;
+} | {
+    kind: "connectWallet";
+    chain: LaunchpadChain;
+    /** Selector for the "Connect Wallet" trigger on the page. */
+    connectButton: string;
+    /** Optional selector for the wallet provider option (e.g. MetaMask). */
+    providerOption?: string;
+    narration?: string;
+} | {
+    kind: "fillField";
+    field: LaunchpadField;
+    selector: string;
+    narration?: string;
+} | {
+    kind: "uploadImage";
+    selector: string;
+    narration?: string;
+} | {
+    kind: "click";
+    selector?: string;
+    text?: string;
+    narration?: string;
+} | {
+    kind: "confirmTx";
+    chain: LaunchpadChain;
+    narration?: string;
+} | {
+    kind: "awaitTxResult";
+    explorerUrlPattern?: string;
+    timeoutMs?: number;
+    narration?: string;
+};
+export interface LaunchpadProfile {
+    /** Stable id used in logs / metadata (e.g. "four-meme:mainnet"). */
+    id: string;
+    /** Display name shown in narration ("four.meme", "flap.sh"). */
+    displayName: string;
+    /** Primary chain the launchpad expects. */
+    chain: LaunchpadChain;
+    /** URL the engine navigates to before any other step. */
+    entryUrl: string;
+    /** Cluster (Solana) or chain id (EVM) used by signers downstream. */
+    network: {
+        evmChainId?: number;
+        solanaCluster?: "mainnet" | "devnet" | "testnet";
+    };
+    /** Ordered step list. */
+    steps: LaunchpadStep[];
+}
+export type LaunchpadDryRun = "off" | "stop-before-tx";
+export interface LaunchpadResult {
+    ok: boolean;
+    profileId: string;
+    /** Step index where execution stopped — last completed step on success. */
+    stoppedAtStep: number;
+    /** Reason (success or failure narration). */
+    reason: string;
+    /** Optional explorer URL for the resulting transaction. */
+    explorerUrl?: string;
+}
+/**
+ * Narration callback signature. The engine calls this BEFORE each step so
+ * the user reads the line as the cursor starts moving. Implementations
+ * route the line into the page-browser conversation as a synthetic agent
+ * message.
+ */
+export type LaunchpadNarrate = (line: string) => void | Promise<void>;
+//# sourceMappingURL=launchpad-types.d.ts.map

package/packages/agent/src/services/launchpads/launchpad-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchpad-types.d.ts","sourceRoot":"","sources":["../../../../../../src/services/launchpads/launchpad-types.ts"],"names":[],"mappings":"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"}

package/packages/agent/src/services/launchpads/launchpad-types.js

@@ -0,0 +1,19 @@
+/**
+ * Launchpad playbook engine — types.
+ *
+ * The engine drives a browser-workspace tab through a hand-curated sequence
+ * of steps to launch a token on a specific launchpad (four.meme on BNB,
+ * flap.sh on Solana, etc.). Each step maps to one BrowserWorkspaceCommand
+ * (or a small composition) and emits a status line in chat before running
+ * so the user can watch and follow along.
+ *
+ * Decisions (locked by plan):
+ *   - User confirms each launch transaction in the existing steward
+ *     approval surface — no auto-sign anywhere in the engine.
+ *   - The engine prefers realistic-* subactions so the cursor moves and
+ *     pointer events fire faithfully. See BROWSER_TAB_PRELOAD_SCRIPT.
+ *   - dryRun: "stop-before-tx" lets smoke tests exercise the entire
+ *     pre-launch flow (wallet connect + form fill + image upload + cursor
+ *     overlay) without submitting a real transaction.
+ */
+export {};

package/packages/agent/src/services/launchpads/metadata-generator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LLM-driven token metadata generation.
+ *
+ * Returns a strict-typed metadata bundle the launchpad engine drops into
+ * the launchpad form. The runtime's existing useModel surface handles
+ * provider routing — same path the rest of the agent uses.
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+export interface GeneratedTokenMetadata {
+    name: string;
+    symbol: string;
+    description: string;
+    imagePrompt: string;
+    theme: string;
+}
+interface MetadataHints {
+    /** Optional theme hint from the user prompt (free-form). */
+    theme?: string;
+    /** Optional symbol seed if the user already has one. */
+    symbolHint?: string;
+}
+export declare function generateTokenMetadata(runtime: IAgentRuntime, hints?: MetadataHints): Promise<GeneratedTokenMetadata>;
+export {};
+//# sourceMappingURL=metadata-generator.d.ts.map

package/packages/agent/src/services/launchpads/metadata-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../src/services/launchpads/metadata-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,eAAe,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAaD,UAAU,aAAa;IACrB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2BD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,KAAK,GAAE,aAAkB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAuDjC"}

package/packages/agent/src/services/launchpads/metadata-generator.js

@@ -0,0 +1,96 @@
+/**
+ * LLM-driven token metadata generation.
+ *
+ * Returns a strict-typed metadata bundle the launchpad engine drops into
+ * the launchpad form. The runtime's existing useModel surface handles
+ * provider routing — same path the rest of the agent uses.
+ */
+import { logger, ModelType } from "@elizaos/core";
+const SYSTEM_PROMPT = `You generate metadata for a meme-coin launchpad submission.
+Reply with strict JSON matching the schema:
+{
+  "name": string (1-32 chars, brandable),
+  "symbol": string (3-6 uppercase letters/digits, no whitespace),
+  "description": string (60-280 chars, single paragraph, marketing-friendly),
+  "imagePrompt": string (one short sentence describing token art for an image generator),
+  "theme": string (one-word or two-word theme for narration like 'cozy DeFi cat')
+}
+No prose, no fences, no extra fields.`;
+function safeParse(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    // Tolerate fenced JSON in case the model wraps it.
+    const stripped = trimmed
+        .replace(/^```(?:json)?\s*/i, "")
+        .replace(/```\s*$/i, "")
+        .trim();
+    try {
+        const parsed = JSON.parse(stripped);
+        return parsed && typeof parsed === "object"
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function clampSymbol(value) {
+    return value
+        .replace(/[^A-Za-z0-9]/g, "")
+        .slice(0, 6)
+        .toUpperCase();
+}
+export async function generateTokenMetadata(runtime, hints = {}) {
+    const userPrompt = [
+        hints.theme ? `Theme hint: ${hints.theme}` : "",
+        hints.symbolHint ? `Symbol hint: ${hints.symbolHint}` : "",
+        "Generate metadata now.",
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const raw = await runtime.useModel(ModelType.TEXT_LARGE, {
+        prompt: `${SYSTEM_PROMPT}\n\n${userPrompt}`,
+    });
+    const text = typeof raw === "string" ? raw : String(raw ?? "");
+    const parsed = safeParse(text);
+    if (!parsed) {
+        logger.warn(`[launchpad] Metadata model returned non-JSON; falling back to a placeholder.`);
+        return fallbackMetadata(hints);
+    }
+    const name = typeof parsed.name === "string" && parsed.name.trim()
+        ? parsed.name.trim().slice(0, 32)
+        : null;
+    const symbolRaw = typeof parsed.symbol === "string" ? clampSymbol(parsed.symbol) : "";
+    const description = typeof parsed.description === "string"
+        ? parsed.description.trim().slice(0, 280)
+        : null;
+    const imagePrompt = typeof parsed.imagePrompt === "string" && parsed.imagePrompt.trim()
+        ? parsed.imagePrompt.trim()
+        : null;
+    const theme = typeof parsed.theme === "string" && parsed.theme.trim()
+        ? parsed.theme.trim()
+        : hints.theme || "meme";
+    if (!name || !symbolRaw || !description || !imagePrompt) {
+        logger.warn(`[launchpad] Metadata model omitted required fields; falling back.`);
+        return fallbackMetadata(hints);
+    }
+    return {
+        name,
+        symbol: symbolRaw,
+        description,
+        imagePrompt,
+        theme,
+    };
+}
+function fallbackMetadata(hints) {
+    const symbol = clampSymbol(hints.symbolHint || "WAGMI") || "WAGMI";
+    const theme = hints.theme || "meme";
+    return {
+        name: `Eliza ${symbol}`,
+        symbol,
+        description: "An autonomously-launched meme token, deployed by an Eliza agent during a watch-mode browser session.",
+        imagePrompt: `friendly meme coin mascot, vibrant colors, ${theme}`,
+        theme,
+    };
+}

package/packages/agent/src/services/launchpads/profiles/flap-sh.d.ts

@@ -0,0 +1,25 @@
+/**
+ * flap.sh — BNB Chain memecoin launchpad profile.
+ *
+ * Under the hood, flap.sh's web UI builds a `newTokenV6(NewTokenV6Params)`
+ * call against the Portal contract and sends it via the user's connected
+ * wallet. Docs:
+ *   https://docs.flap.sh/flap/developers/token-launcher-developers
+ *
+ * Deployed Portals (per docs/deployed-contract-addresses):
+ *   - BNB mainnet (chain 56):  Portal 0xe2cE6ab80874Fa9Fa2aAE65D277Dd6B8e65C9De0
+ *   - BNB testnet (chain 97):  Portal 0x5bEacaF7ABCbB3aB280e80D007FD31fcE26510e9
+ *
+ * Because the launch terminates in a standard EVM `eth_sendTransaction`
+ * sent through `window.ethereum`, our existing browser-wallet bridge +
+ * steward sign path handles this without any Solana plumbing — the user
+ * confirms the tx in the steward approval sheet exactly like four.meme.
+ *
+ * Selectors below are best-effort first cuts and need to be tuned against
+ * the live site at smoke time. flap.sh's UI changes; if a step fails on
+ * "not found" this is the right place to update.
+ */
+import type { LaunchpadProfile } from "../launchpad-types.js";
+export declare const flapShMainnetProfile: LaunchpadProfile;
+export declare const flapShTestnetProfile: LaunchpadProfile;
+//# sourceMappingURL=flap-sh.d.ts.map

package/packages/agent/src/services/launchpads/profiles/flap-sh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flap-sh.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/launchpads/profiles/flap-sh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,eAAO,MAAM,oBAAoB,EAAE,gBAqDlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBASlC,CAAC"}

package/packages/agent/src/services/launchpads/profiles/flap-sh.js

@@ -0,0 +1,80 @@
+/**
+ * flap.sh — BNB Chain memecoin launchpad profile.
+ *
+ * Under the hood, flap.sh's web UI builds a `newTokenV6(NewTokenV6Params)`
+ * call against the Portal contract and sends it via the user's connected
+ * wallet. Docs:
+ *   https://docs.flap.sh/flap/developers/token-launcher-developers
+ *
+ * Deployed Portals (per docs/deployed-contract-addresses):
+ *   - BNB mainnet (chain 56):  Portal 0xe2cE6ab80874Fa9Fa2aAE65D277Dd6B8e65C9De0
+ *   - BNB testnet (chain 97):  Portal 0x5bEacaF7ABCbB3aB280e80D007FD31fcE26510e9
+ *
+ * Because the launch terminates in a standard EVM `eth_sendTransaction`
+ * sent through `window.ethereum`, our existing browser-wallet bridge +
+ * steward sign path handles this without any Solana plumbing — the user
+ * confirms the tx in the steward approval sheet exactly like four.meme.
+ *
+ * Selectors below are best-effort first cuts and need to be tuned against
+ * the live site at smoke time. flap.sh's UI changes; if a step fails on
+ * "not found" this is the right place to update.
+ */
+export const flapShMainnetProfile = {
+    id: "flap-sh:mainnet",
+    displayName: "flap.sh",
+    chain: "evm",
+    entryUrl: "https://flap.sh/create",
+    network: { evmChainId: 56 },
+    steps: [
+        { kind: "navigate", url: "https://flap.sh/create" },
+        {
+            kind: "waitFor",
+            selector: "input[name='name'], input[placeholder*='Name' i]",
+            timeoutMs: 12_000,
+        },
+        {
+            kind: "connectWallet",
+            chain: "evm",
+            connectButton: "button:has-text('Connect Wallet'), button:has-text('Connect'), [data-testid='connect-wallet']",
+            narration: "Connecting BSC wallet",
+        },
+        {
+            kind: "fillField",
+            field: "name",
+            selector: "input[name='name'], input[placeholder*='Name' i]",
+        },
+        {
+            kind: "fillField",
+            field: "symbol",
+            selector: "input[name='symbol'], input[name='ticker'], input[placeholder*='Symbol' i], input[placeholder*='Ticker' i]",
+        },
+        {
+            kind: "fillField",
+            field: "description",
+            selector: "textarea[name='description'], textarea[placeholder*='Description' i]",
+        },
+        {
+            kind: "uploadImage",
+            selector: "input[type='file']",
+        },
+        {
+            kind: "click",
+            text: "Launch",
+            narration: "Submitting — please confirm in your wallet",
+        },
+        { kind: "confirmTx", chain: "evm" },
+        {
+            kind: "awaitTxResult",
+            explorerUrlPattern: "bscscan.com",
+            timeoutMs: 90_000,
+        },
+    ],
+};
+export const flapShTestnetProfile = {
+    ...flapShMainnetProfile,
+    id: "flap-sh:testnet",
+    network: { evmChainId: 97 },
+    steps: flapShMainnetProfile.steps.map((step) => step.kind === "awaitTxResult"
+        ? { ...step, explorerUrlPattern: "testnet.bscscan.com" }
+        : step),
+};

package/packages/agent/src/services/launchpads/profiles/four-meme.d.ts

@@ -0,0 +1,11 @@
+/**
+ * four.meme — BNB Chain memecoin launchpad profile.
+ *
+ * Selectors are best-effort first cuts and need to be tuned against the
+ * live site during smoke testing. The launchpad UI changes; if a step
+ * fails on a "not found" error the profile is the right place to update.
+ */
+import type { LaunchpadProfile } from "../launchpad-types.js";
+export declare const fourMemeMainnetProfile: LaunchpadProfile;
+export declare const fourMemeTestnetProfile: LaunchpadProfile;
+//# sourceMappingURL=four-meme.d.ts.map

package/packages/agent/src/services/launchpads/profiles/four-meme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"four-meme.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/launchpads/profiles/four-meme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,eAAO,MAAM,sBAAsB,EAAE,gBAqDpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAYpC,CAAC"}

package/packages/agent/src/services/launchpads/profiles/four-meme.js

@@ -0,0 +1,70 @@
+/**
+ * four.meme — BNB Chain memecoin launchpad profile.
+ *
+ * Selectors are best-effort first cuts and need to be tuned against the
+ * live site during smoke testing. The launchpad UI changes; if a step
+ * fails on a "not found" error the profile is the right place to update.
+ */
+export const fourMemeMainnetProfile = {
+    id: "four-meme:mainnet",
+    displayName: "four.meme",
+    chain: "evm",
+    entryUrl: "https://four.meme/create-token",
+    network: { evmChainId: 56 },
+    steps: [
+        { kind: "navigate", url: "https://four.meme/create-token" },
+        {
+            kind: "waitFor",
+            selector: "input[name='name'], input[placeholder*='Name' i]",
+            timeoutMs: 12_000,
+        },
+        {
+            kind: "connectWallet",
+            chain: "evm",
+            connectButton: "button:has-text('Connect Wallet'), [data-testid='connect-wallet']",
+            providerOption: "[data-wallet='metamask']",
+            narration: "Connecting BSC wallet",
+        },
+        {
+            kind: "fillField",
+            field: "name",
+            selector: "input[name='name'], input[placeholder*='Name' i]",
+        },
+        {
+            kind: "fillField",
+            field: "symbol",
+            selector: "input[name='symbol'], input[placeholder*='Symbol' i]",
+        },
+        {
+            kind: "fillField",
+            field: "description",
+            selector: "textarea[name='description'], textarea[placeholder*='Description' i]",
+        },
+        {
+            kind: "uploadImage",
+            selector: "input[type='file']",
+        },
+        {
+            kind: "click",
+            text: "Launch",
+            narration: "Submitting — please confirm in your wallet",
+        },
+        { kind: "confirmTx", chain: "evm" },
+        {
+            kind: "awaitTxResult",
+            explorerUrlPattern: "bscscan.com",
+            timeoutMs: 90_000,
+        },
+    ],
+};
+export const fourMemeTestnetProfile = {
+    ...fourMemeMainnetProfile,
+    id: "four-meme:testnet",
+    entryUrl: "https://test.four.meme/create-token",
+    network: { evmChainId: 97 },
+    steps: fourMemeMainnetProfile.steps.map((step) => step.kind === "navigate"
+        ? { ...step, url: "https://test.four.meme/create-token" }
+        : step.kind === "awaitTxResult"
+            ? { ...step, explorerUrlPattern: "testnet.bscscan.com" }
+            : step),
+};

package/packages/agent/src/services/registry-client.js

@@ -75,7 +75,7 @@ function normalizeRegistryFilterKey(value) {
     return (value ?? "")
         .trim()
         .toLowerCase()
-        .replace(/\s*&\s*/g, " and ")
+        .replace(/\s{0,32}&\s{0,32}/g, " and ")
         .replace(/[^a-z0-9/]+/g, "-")
         .replace(/^-+|-+$/g, "");
 }

package/packages/agent/src/services/research-task-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research-task-executor.d.ts","sourceRoot":"","sources":["../../../../../src/services/research-task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK7E;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,mEAC8C;IAElE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO;IAKrD,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAoIpE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C"}
+{"version":3,"file":"research-task-executor.d.ts","sourceRoot":"","sources":["../../../../../src/services/research-task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK7E;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,mEAC8C;IAElE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO;IAKrD,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAyIpE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C"}