¶ AgentAuth SDK

import GenAuth from "@genauth/agentauth";

// Create GenAuth instance
const genAuth = new GenAuth({
  genAuthUserId: "your-user-id",
  tenantId: "user-pools-id",
  cdpUrl: "ws://localhost:9222", // Optional, Chrome DevTools Protocol URL
});

// Send natural language instruction
try {
  const response = await genAuth.chat("I am a marketing campaign operator, please help me register an Twitter account");
  console.log("Operation completed:", response);
} catch (error) {
  console.error("Operation failed:", error);
}

// Listen for messages and browser events
genAuth.onMessage(async (resData) => {
  console.log("Received message:", resData);

  if (resData.action === "browser_event") {
    console.log("Browser operation:", resData.otherData);
  }
});

// Listen for task progress
genAuth.onProgress(async (progressData) => {
  const { taskId, status, progress } = progressData;
  console.log(`Task ${taskId} Step ${progress}: ${status}`);
});

interface GenAuthConfig {
  genAuthUserId: string; // Required: User ID
  tenantId: string; // Required: Tenant ID, or connection pool ID
  genAuthServer?: string; // Optional: Server address, default: http://39.104.83.45:13032
  cdpUrl?: string; // Optional: Chrome DevTools Protocol WebSocket URL
  proxyPools?: ProxyConfig[]; // Optional: Proxy pools for CDP instances
}

const config = {
  genAuthUserId: "user-123",
  tenantId: "tenant-123",
  genAuthServer: "https://your-server.com",
  cdpUrl: "ws://localhost:9222",
};

const genAuth = new GenAuth(config);

const response = await genAuth.chat('I am an operator of an MCN agency and need to open Instagram accounts for 20+ influencers every month. Please help me automatically generate account information that meets the standards and complete registration and verification through a cloud virtual number.');

interface ResData {
  taskId: string; // Unique task identifier
  step: number; // Execution step
  action: ActionEnum; // Action type
  message?: string; // Message content
  otherData?: any; // Additional data
}

interface ProgressData {
  taskId: string; // Task ID
  action: ActionEnum; // Action type
  status: ProgressStatusEnum; // Execution status
  progress?: number; // Current step
  otherData?: any; // Browser operation data
  img?: string; // Base64 encoded screenshot
  uuid?: string; // Unique identifier
}

enum ActionEnum {
  message = "message", // Normal message
  browser_event = "browser_event", // Browser event
  screenshot = "screenshot", // Screenshot event
}

enum ProgressStatusEnum {
  start = "start", // Start execution
  sucess = "sucess", // Execution successful
  error = "error", // Execution failed
}

import GenAuth from "@genauth/agentauth";

async function automateWebTask() {
  // Initialize SDK
  const genAuth = new GenAuth({
    genAuthUserId: "demo-user-001",
    tenantId: "demo-tenant-001",
    cdpUrl: "ws://localhost:9222",
  });

  // Set message listener
  genAuth.onMessage(async (resData) => {
    console.log(`📢 [${resData.action}] ${resData.message || "Event triggered"}`);

    if (resData.action === "browser_event" && resData.otherData?.actions) {
      resData.otherData.actions.forEach((action: any, index: number) => {
        console.log(
          `   ${index + 1}. ${action.method}: ${
            action.value || action.selector
          }`
        );
      });
    }
  });

  // Set progress listener
  genAuth.onProgress(async (progressData) => {
    const statusIcon = {
      start: "🚀",
      sucess: "✅",
      error: "❌",
    }[progressData.status];

    console.log(
      `${statusIcon} Task progress: ${progressData.progress}/${
        progressData.otherData?.length || 0
      }`
    );

    if (progressData.img) {
      console.log("📸 Screenshot generated");
    }
  });

  try {
    console.log("🎯 Starting automation task...");

    // Execute a sequence of complex browser operations
    let response = await genAuth.chat("Log me into Instagram");
    console.log("Step 1 completed:", response);

    response = await genAuth.chat('Search for "Currently Most Popular Products"');
    console.log("Step 2 completed:", response);

    response = await genAuth.chat("Click the first search result");
    console.log("Step 3 completed:", response);

    console.log("🎉 All tasks completed!");
  } catch (error) {
    console.error("❌ Task execution failed:", error.message);
  } finally {
    // Clean up resources
    await genAuth.destroy();
    console.log("🧹 Resources cleaned up");
  }
}

// Run the example
automateWebTask().catch(console.error);

import GenAuth from "@genauth/agentauth";

const genAuth = new GenAuth({
  genAuthUserId: "your-user-id",
  tenantId: "your-tenant-id",
});

try {
  const response = await genAuth.chat("your instruction");
  console.log("Success:", response);
} catch (error) {
  // Handle errors based on type
  if (error.message.includes("sessionId")) {
    console.error("⚠️ Session connection failed, please check network connection");
    // You can try to reconnect
  } else if (error.message.includes("browserType.connectOverCDP")) {
    console.error("⚠️ Browser connection failed, please ensure Chrome debugging mode is started");
  } else if (error.message.includes("apiCode")) {
    console.error("⚠️ API call failed:", error.message);
  } else {
    console.error("⚠️ Unknown error:", error);
  }
}