drip-agent 0.1.0

package/README.md

@@ -0,0 +1,116 @@
+# drip-agent
+
+Autonomous research intelligence from the command line. Company lookups, people enrichment, and web research — powered by [AgentCash](https://agentcash.dev) micropayments.
+
+## Quick Start
+
+```bash
+# Set up wallet (one-time)
+npx drip-agent setup
+
+# Research a company
+npx drip-agent research anthropic.com
+
+# Enrich a person
+npx drip-agent enrich john@company.com
+
+# Check balance
+npx drip-agent balance
+```
+
+## Install
+
+```bash
+# Use directly with npx (no install needed)
+npx drip-agent research coinbase.com
+
+# Or install globally
+npm install -g drip-agent
+drip-agent research stripe.com
+```
+
+## Commands
+
+### `research <query>`
+
+Look up company intelligence by domain or name.
+
+```bash
+drip-agent research anthropic.com
+drip-agent research "Coinbase"        # auto-resolves to coinbase.com
+drip-agent research stripe.com -f json  # JSON output
+```
+
+Returns: name, industry, funding, headcount, HQ, tech stack, key links.
+
+**Cost:** ~$0.05 per lookup
+
+### `enrich <email|linkedin>`
+
+Enrich a person's profile by email or LinkedIn URL.
+
+```bash
+drip-agent enrich john@company.com
+drip-agent enrich https://linkedin.com/in/johndoe
+drip-agent enrich jane@startup.io -f json
+```
+
+Returns: name, title, company, location, contact info, employment history.
+
+**Cost:** ~$0.05 per lookup
+
+### `setup [invite-code]`
+
+Set up your AgentCash wallet for paid API access.
+
+```bash
+drip-agent setup                    # basic setup
+drip-agent setup AC-XXXX-XXXX      # with invite code for free credits
+```
+
+### `balance`
+
+Check your AgentCash wallet balance and deposit link.
+
+```bash
+drip-agent balance
+```
+
+## How It Works
+
+1. You run a command
+2. DRIP calls [StableEnrich](https://stableenrich.dev) via [AgentCash](https://agentcash.dev)
+3. Payment is automatic — USDC micropayment on Solana
+4. Results appear in your terminal
+
+No API keys. No subscriptions. Pay per query.
+
+## Pricing
+
+| Command | Cost |
+|---------|------|
+| `research` | ~$0.05 |
+| `enrich` | ~$0.05 |
+
+Payments settle on success only — failed requests don't cost anything.
+
+## Programmatic Usage
+
+```js
+import { companyResearch, personEnrich } from "drip-agent";
+
+const company = await companyResearch("anthropic.com");
+const person = await personEnrich({ email: "john@company.com" });
+```
+
+Requires AgentCash wallet set up locally (`npx drip-agent setup`).
+
+## Links
+
+- **Website:** [drip.surf](https://drip.surf)
+- **Agent:** [agent.drip.surf](https://agent.drip.surf)
+- **Token:** $DRIP on PumpFun
+
+---
+
+Built by DRIP × AgentCash

package/bin/drip-agent.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+import { createRequire } from "module";
+import { program } from "commander";
+import { researchCommand } from "../src/commands/research.js";
+import { enrichCommand } from "../src/commands/enrich.js";
+import { setupCommand } from "../src/commands/setup.js";
+import { balanceCommand } from "../src/commands/balance.js";
+import { interactiveMode } from "../src/interactive.js";
+
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+
+program
+  .name("drip-agent")
+  .description("DRIP — autonomous research intelligence from the terminal")
+  .version(pkg.version);
+
+program
+  .command("research <query>")
+  .description("Research a company by domain or name")
+  .option("-f, --format <type>", "Output format: text, json, markdown", "text")
+  .action(researchCommand);
+
+program
+  .command("enrich <identifier>")
+  .description("Enrich a person by email or LinkedIn URL")
+  .option("-f, --format <type>", "Output format: text, json, markdown", "text")
+  .action(enrichCommand);
+
+program
+  .command("setup [invite-code]")
+  .description("Set up AgentCash wallet for paid API access")
+  .action(setupCommand);
+
+program
+  .command("balance")
+  .description("Check your AgentCash wallet balance")
+  .action(balanceCommand);
+
+// No arguments → interactive mode
+if (process.argv.length <= 2) {
+  interactiveMode();
+} else {
+  program.parse();
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "drip-agent",
+  "version": "0.1.0",
+  "description": "DRIP — autonomous research intelligence from the command line. Company lookups, people enrichment, and web research powered by AgentCash micropayments.",
+  "keywords": [
+    "drip",
+    "research",
+    "agent",
+    "ai",
+    "company-research",
+    "people-enrichment",
+    "agentcash",
+    "x402"
+  ],
+  "license": "MIT",
+  "author": "DRIP",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/drip-agent/drip"
+  },
+  "homepage": "https://drip.surf",
+  "bin": {
+    "drip-agent": "./bin/drip-agent.js"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "chalk": "^5.4.0",
+    "commander": "^13.0.0",
+    "ora": "^8.0.0"
+  }
+}

package/src/commands/balance.js

@@ -0,0 +1,28 @@
+import { execSync } from "child_process";
+import chalk from "chalk";
+
+export async function balanceCommand() {
+  try {
+    const out = execSync("npx agentcash@latest wallet info", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    const data = JSON.parse(out);
+    if (data.success) {
+      const w = data.data;
+      console.log(chalk.cyan.bold("\n  💧 DRIP Wallet\n"));
+      console.log(`  Address:  ${chalk.dim(w.address)}`);
+      console.log(`  Balance:  ${chalk.green.bold("$" + w.balance)} USDC`);
+      if (w.chains) {
+        for (const c of w.chains) {
+          console.log(`            ${chalk.dim(c.paymentNetwork)}: $${c.balance}`);
+        }
+      }
+      console.log(`\n  Deposit:  ${chalk.underline(w.depositLink)}\n`);
+    } else {
+      console.log(out);
+    }
+  } catch {
+    console.error(chalk.red("No wallet found. Run: drip-agent setup"));
+  }
+}

package/src/commands/enrich.js

@@ -0,0 +1,109 @@
+import chalk from "chalk";
+import ora from "ora";
+import { personEnrich } from "../index.js";
+
+export async function enrichCommand(identifier, options) {
+  const isEmail = identifier.includes("@");
+  const isLinkedIn = identifier.includes("linkedin.com");
+
+  if (!isEmail && !isLinkedIn) {
+    console.error(
+      chalk.red("\n  Provide an email address or LinkedIn URL\n")
+    );
+    console.log(
+      chalk.dim("  Examples:\n") +
+        chalk.dim("    drip-agent enrich john@company.com\n") +
+        chalk.dim(
+          "    drip-agent enrich https://linkedin.com/in/johndoe\n"
+        )
+    );
+    process.exit(1);
+  }
+
+  const spinner = ora({
+    text: chalk.dim(`Enriching ${identifier}...`),
+    color: "cyan",
+  }).start();
+
+  try {
+    const params = isEmail
+      ? { email: identifier }
+      : { linkedinUrl: identifier };
+
+    const data = await personEnrich(params);
+    spinner.stop();
+
+    if (options.format === "json") {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+
+    const person = data?.person || data?.data?.person || data;
+
+    if (!person || (typeof person === "object" && Object.keys(person).length === 0)) {
+      console.log(chalk.yellow(`\n  No data found for ${identifier}\n`));
+      return;
+    }
+
+    console.log("");
+    console.log(
+      chalk.cyan.bold(
+        `  💧 ${person.first_name || ""} ${person.last_name || ""}`
+      )
+    );
+    console.log(chalk.dim(`  ${"─".repeat(50)}`));
+
+    if (person.title) {
+      console.log(`\n  ${chalk.white(person.title)}`);
+    }
+
+    console.log("");
+
+    const fields = [
+      ["Company", person.organization?.name || person.organization_name],
+      ["Email", person.email],
+      ["Phone", person.phone_numbers?.[0]?.sanitized_number],
+      ["Location", [person.city, person.state, person.country].filter(Boolean).join(", ")],
+      ["LinkedIn", person.linkedin_url],
+      ["Twitter", person.twitter_url],
+      ["GitHub", person.github_url],
+      ["Seniority", person.seniority],
+      ["Department", person.departments?.join(", ")],
+    ];
+
+    for (const [label, value] of fields) {
+      if (value) {
+        console.log(`  ${chalk.dim(label.padEnd(14))} ${value}`);
+      }
+    }
+
+    if (person.employment_history?.length > 0) {
+      console.log(chalk.dim(`\n  Recent roles:`));
+      for (const job of person.employment_history.slice(0, 3)) {
+        const current = job.current ? chalk.green(" ●") : "";
+        console.log(
+          `  ${chalk.dim("·")} ${job.title} at ${job.organization_name}${current}`
+        );
+      }
+    }
+
+    console.log(chalk.dim(`\n  ${"─".repeat(50)}`));
+    console.log(chalk.dim("  Powered by DRIP × AgentCash\n"));
+  } catch (err) {
+    spinner.stop();
+    const msg = err.message || String(err);
+
+    if (msg.includes("Insufficient balance") || msg.includes("balance")) {
+      console.error(
+        chalk.red("\n  Insufficient balance. Run: drip-agent balance\n")
+      );
+    } else if (msg.includes("wallet") || msg.includes("agentcash")) {
+      console.error(
+        chalk.red("\n  AgentCash not set up. Run: drip-agent setup\n")
+      );
+    } else {
+      console.error(chalk.red(`\n  Enrichment failed: ${msg}\n`));
+    }
+    process.exit(1);
+  }
+}

package/src/commands/research.js

@@ -0,0 +1,88 @@
+import chalk from "chalk";
+import ora from "ora";
+import { companyResearch } from "../index.js";
+
+export async function researchCommand(query, options) {
+  // Normalize: if it looks like a domain, use directly; otherwise guess
+  const domain = query.includes(".")
+    ? query
+    : `${query.toLowerCase().replace(/\s+/g, "")}.com`;
+
+  const spinner = ora({
+    text: chalk.dim(`Researching ${domain}...`),
+    color: "cyan",
+  }).start();
+
+  try {
+    const data = await companyResearch(domain);
+    spinner.stop();
+
+    if (options.format === "json") {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+
+    // Extract org data — handle Apollo's response shape
+    const org = data?.organization || data?.data?.organization || data;
+
+    if (!org || (typeof org === "object" && Object.keys(org).length === 0)) {
+      console.log(chalk.yellow(`\n  No data found for ${domain}\n`));
+      return;
+    }
+
+    console.log("");
+    console.log(chalk.cyan.bold(`  💧 ${org.name || domain}`));
+    console.log(chalk.dim(`  ${"─".repeat(50)}`));
+
+    if (org.short_description || org.description) {
+      console.log(
+        `\n  ${chalk.white(org.short_description || org.description)}`
+      );
+    }
+
+    console.log("");
+
+    const fields = [
+      ["Industry", org.industry],
+      ["Founded", org.founded_year],
+      ["Employees", org.estimated_num_employees?.toLocaleString()],
+      ["HQ", [org.city, org.state, org.country].filter(Boolean).join(", ")],
+      ["Website", org.website_url || org.primary_domain],
+      ["LinkedIn", org.linkedin_url],
+      ["Funding", org.total_funding ? `$${(org.total_funding / 1_000_000).toFixed(1)}M` : null],
+      ["Latest Round", org.latest_funding_round_type],
+      ["Tech Stack", org.technologies?.slice(0, 5)?.join(", ")],
+    ];
+
+    for (const [label, value] of fields) {
+      if (value) {
+        console.log(`  ${chalk.dim(label.padEnd(14))} ${value}`);
+      }
+    }
+
+    if (org.keywords?.length > 0) {
+      console.log(
+        `\n  ${chalk.dim("Tags")}          ${org.keywords.slice(0, 8).join(" · ")}`
+      );
+    }
+
+    console.log(chalk.dim(`\n  ${"─".repeat(50)}`));
+    console.log(chalk.dim("  Powered by DRIP × AgentCash\n"));
+  } catch (err) {
+    spinner.stop();
+    const msg = err.message || String(err);
+
+    if (msg.includes("Insufficient balance") || msg.includes("balance")) {
+      console.error(
+        chalk.red("\n  Insufficient balance. Run: drip-agent balance\n")
+      );
+    } else if (msg.includes("wallet") || msg.includes("agentcash")) {
+      console.error(
+        chalk.red("\n  AgentCash not set up. Run: drip-agent setup\n")
+      );
+    } else {
+      console.error(chalk.red(`\n  Research failed: ${msg}\n`));
+    }
+    process.exit(1);
+  }
+}

package/src/commands/setup.js

@@ -0,0 +1,29 @@
+import chalk from "chalk";
+import { execSync } from "child_process";
+
+export async function setupCommand(inviteCode) {
+  console.log(chalk.cyan.bold("\n  💧 DRIP Agent Setup\n"));
+
+  try {
+    const cmd = inviteCode
+      ? `npx agentcash@latest onboard ${inviteCode}`
+      : `npx agentcash@latest onboard`;
+
+    console.log(chalk.dim("  Setting up AgentCash wallet...\n"));
+
+    execSync(cmd, {
+      encoding: "utf-8",
+      stdio: "inherit",
+      timeout: 120_000,
+    });
+
+    console.log(chalk.green.bold("\n  ✓ Setup complete!\n"));
+    console.log(chalk.dim("  Try it out:"));
+    console.log(`    ${chalk.cyan("drip-agent research anthropic.com")}`);
+    console.log(`    ${chalk.cyan("drip-agent enrich john@company.com")}`);
+    console.log(`    ${chalk.cyan("drip-agent balance")}\n`);
+  } catch (err) {
+    console.error(chalk.red(`\n  Setup failed: ${err.message}\n`));
+    process.exit(1);
+  }
+}

package/src/index.js

@@ -0,0 +1,48 @@
+import { execSync } from "child_process";
+
+const STABLEENRICH = "https://stableenrich.dev";
+
+/**
+ * Make a paid API call via AgentCash CLI.
+ * Returns parsed JSON response.
+ */
+export function agentcashFetch(url, method = "GET", body = null) {
+  const args = [`npx agentcash@latest fetch '${url}'`, `-m ${method}`, `--format json`];
+  if (body) {
+    args.push(`-b '${JSON.stringify(body)}'`);
+  }
+
+  const output = execSync(args.join(" "), {
+    encoding: "utf-8",
+    timeout: 60_000,
+    stdio: ["pipe", "pipe", "pipe"],
+  });
+
+  return JSON.parse(output.trim());
+}
+
+/**
+ * Research a company via StableEnrich Apollo org enrichment.
+ */
+export async function companyResearch(domain) {
+  return agentcashFetch(
+    `${STABLEENRICH}/api/apollo/org-enrich`,
+    "POST",
+    { domain }
+  );
+}
+
+/**
+ * Enrich a person via StableEnrich Apollo people enrichment.
+ */
+export async function personEnrich({ email, linkedinUrl }) {
+  const body = {};
+  if (email) body.email = email;
+  if (linkedinUrl) body.linkedin_url = linkedinUrl;
+
+  return agentcashFetch(
+    `${STABLEENRICH}/api/apollo/people-enrich`,
+    "POST",
+    body
+  );
+}

package/src/interactive.js

@@ -0,0 +1,95 @@
+import { select, input } from "@inquirer/prompts";
+import chalk from "chalk";
+import { researchCommand } from "./commands/research.js";
+import { enrichCommand } from "./commands/enrich.js";
+import { setupCommand } from "./commands/setup.js";
+import { balanceCommand } from "./commands/balance.js";
+
+export async function interactiveMode() {
+  console.log(
+    chalk.cyan.bold("\n  💧 DRIP") +
+      chalk.dim(" — autonomous research intelligence\n")
+  );
+
+  const action = await select({
+    message: "What do you want to do?",
+    choices: [
+      {
+        name: "🔍 Research a company",
+        value: "research",
+        description: "Look up company intel by domain or name (~$0.05)",
+      },
+      {
+        name: "👤 Enrich a person",
+        value: "enrich",
+        description: "Find profile data by email or LinkedIn (~$0.05)",
+      },
+      {
+        name: "💰 Check balance",
+        value: "balance",
+        description: "View your AgentCash wallet balance",
+      },
+      {
+        name: "⚙️  Set up wallet",
+        value: "setup",
+        description: "Configure AgentCash for paid API access",
+      },
+    ],
+  });
+
+  switch (action) {
+    case "research": {
+      const query = await input({
+        message: "Company domain or name:",
+        required: true,
+        validate: (v) => (v.trim() ? true : "Enter a company domain or name"),
+      });
+      await researchCommand(query, { format: "text" });
+      break;
+    }
+
+    case "enrich": {
+      const identifier = await input({
+        message: "Email or LinkedIn URL:",
+        required: true,
+        validate: (v) => {
+          const s = v.trim();
+          if (!s) return "Enter an email or LinkedIn URL";
+          if (!s.includes("@") && !s.includes("linkedin.com"))
+            return "Enter a valid email or LinkedIn URL";
+          return true;
+        },
+      });
+      await enrichCommand(identifier, { format: "text" });
+      break;
+    }
+
+    case "balance":
+      await balanceCommand();
+      break;
+
+    case "setup": {
+      const code = await input({
+        message: "Invite code (leave empty to skip):",
+      });
+      await setupCommand(code || undefined);
+      break;
+    }
+  }
+
+  // Ask if they want to continue
+  console.log("");
+  const again = await select({
+    message: "Continue?",
+    choices: [
+      { name: "Yes — do something else", value: true },
+      { name: "No — exit", value: false },
+    ],
+  });
+
+  if (again) {
+    await interactiveMode();
+  } else {
+    console.log(chalk.dim("\n  drip.surf · $DRIP\n"));
+  }
+}