orangeslice 1.7.7 → 1.7.9

package/README.md

@@ -1,158 +1,107 @@
 # orangeslice
 
-Turn any AI agent into a B2B sales research assistant with access to **1B+ LinkedIn profiles**.
+B2B LinkedIn database prospector. **1.15B profiles, 85M companies.**
 
 ```bash
 npx orangeslice
 ```
 
-This copies documentation to `./orangeslice-docs/` and installs the package. Point your AI agent (Claude Code, Cursor, etc.) to `./orangeslice-docs/AGENTS.md` and it becomes your sales research agent.
+This installs documentation your AI agent needs to master the database. Point your agent (Claude Code, Cursor, etc.) to `./AGENTS.md` and it becomes a B2B prospecting expert.
 
-## What Your Agent Can Do
+## What It Does
 
-| Function | Capability |
-|----------|------------|
-| `b2b` | Query 1B+ LinkedIn profiles, companies, funding, jobs |
-| `serp` | Google search for news, articles, reviews |
-| `firecrawl` | Scrape static websites, extract social URLs |
-| `browser` | Playwright automation for dynamic/JS sites |
+Your AI agent gets:
+- Full database schema (40+ tables)
+- Query patterns and examples
+- Anti-patterns to avoid
+- Performance rules
+- **Parallelization patterns** — agents must run queries in parallel, never sequentially
 
-## Quick Example
-
-```typescript
-import { orangeslice } from 'orangeslice';
+## 🚨 CRITICAL: Always Parallelize
 
-// B2B Database - Company + people research
-const company = await orangeslice.b2b.sql(`
-  SELECT company_name, employee_count, description
-  FROM linkedin_company WHERE domain = 'stripe.com'
-`);
+**The #1 rule: NEVER run queries sequentially. ALWAYS use `Promise.all()`.**
 
-// Google Search - Find news and articles
-const news = await orangeslice.serp.search("Stripe funding 2024");
+The API handles rate limiting automatically. Fire all queries at once.
 
-// Website Scraping - Get page content + social links
-const about = await orangeslice.firecrawl.scrape("https://stripe.com/about");
-console.log(about.markdown);      // Page as markdown
-console.log(about.socialUrls);    // LinkedIn, Twitter, etc.
+```typescript
+// ❌ WRONG - Sequential (SLOW)
+const company = await orangeslice.b2b.sql("...");
+const funding = await orangeslice.b2b.sql("...");
+const jobs = await orangeslice.b2b.sql("...");
+
+// ✅ CORRECT - Parallel (FAST)
+const [company, funding, jobs] = await Promise.all([
+  orangeslice.b2b.sql("..."),
+  orangeslice.b2b.sql("..."),
+  orangeslice.b2b.sql("..."),
+]);
 ```
 
-All calls are rate-limited automatically.
-
-## Documentation
-
-| Doc | What it covers |
-|-----|----------------|
-| [**AGENTS.md**](./docs/AGENTS.md) | **Start here** - Sales agent instructions |
-| [B2B_DATABASE.md](./docs/B2B_DATABASE.md) | Database overview, query examples |
-| [B2B_SCHEMA.md](./docs/B2B_SCHEMA.md) | All tables and columns |
-| [B2B_EMPLOYEE_SEARCH.md](./docs/B2B_EMPLOYEE_SEARCH.md) | Finding people by title/company |
-| [B2B_GENERALIZATION_RULES.md](./docs/B2B_GENERALIZATION_RULES.md) | Query patterns and best practices |
-| [B2B_NLP_QUERY_MAPPINGS.md](./docs/B2B_NLP_QUERY_MAPPINGS.md) | Natural language to SQL mappings |
-
-## Installation
-
-```bash
-npm install orangeslice
-```
+## Quick Example
 
-### TypeScript Setup
+```typescript
+import { orangeslice } from 'orangeslice';
 
-If running `.ts` files directly with `ts-node` or `tsx`, you may need:
+// Research a company - ALL queries in parallel
+const [company, funding, recentJobs, leadership] = await Promise.all([
+  orangeslice.b2b.sql(`SELECT * FROM linkedin_company WHERE domain = 'stripe.com'`),
+  orangeslice.b2b.sql(`SELECT * FROM linkedin_crunchbase_funding WHERE linkedin_company_id = 123`),
+  orangeslice.b2b.sql(`SELECT * FROM linkedin_job WHERE linkedin_company_id = 123 LIMIT 10`),
+  orangeslice.b2b.sql(`
+    SELECT p.first_name, p.last_name, pos.title
+    FROM linkedin_profile p
+    JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = p.id
+    WHERE pos.linkedin_company_id = 123 AND pos.end_date IS NULL
+    LIMIT 10
+  `),
+]);
 
-```bash
-npm install -D typescript @types/node tsx
+// Research multiple companies - ALL in parallel
+const domains = ['stripe.com', 'openai.com', 'anthropic.com'];
+const companies = await Promise.all(
+  domains.map(d => orangeslice.b2b.sql(`SELECT * FROM linkedin_company WHERE domain = '${d}'`))
+);
 ```
 
-Recommended `tsconfig.json`:
-
-```json
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "esModuleInterop": true,
-    "strict": false,
-    "skipLibCheck": true
-  }
-}
-```
+## Documentation
 
-Then run with:
+After running `npx orangeslice`, you get:
 
-```bash
-npx tsx your-script.ts
 ```
-
-## Usage
-
-```typescript
-import { orangeslice } from 'orangeslice';
-
-// Query the B2B database - automatically rate-limited
-const companies = await orangeslice.b2b.sql(`
-  SELECT company_name, domain, employee_count 
-  FROM linkedin_company 
-  WHERE universal_name = 'stripe'
-`);
-
-// Multiple parallel calls are queued (max 2 concurrent by default)
-const results = await Promise.all([
-  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'stripe'"),
-  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'openai'"),
-  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'meta'"),
-  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'google'"),
-  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'amazon'"),
-]);
-// ^ Only 2 run at once, rest wait in queue automatically
+orangeslice-docs/
+├── AGENTS.md              # Agent instructions (includes parallelization rules)
+└── linkedin_data/
+    ├── QUICK_REF.md       # START HERE - Critical rules & patterns
+    ├── tables/            # Full schema (denormalized + normalized)
+    └── search_examples/   # Query patterns for people & companies
 ```
 
-## Configuration
-
-```typescript
-// Optional - configure before use
-orangeslice.b2b.configure({
-  proxyUrl: 'http://your-proxy-url:3000/query',  // default: B2B_SQL_PROXY_URL env var
-  concurrency: 3,                                  // default: 2
-  minDelayMs: 200,                                 // default: 100ms between requests
-});
-```
+**Read `linkedin_data/QUICK_REF.md` before writing any queries.**
 
-## Environment Variables
+## Installation
 
 ```bash
-B2B_SQL_PROXY_URL=http://165.22.151.131:3000/query
-```
-
-## How It Works
-
-```
-Agent calls:  [1] [2] [3] [4] [5] [6]
-                ↓
-Queue:       [ 1, 2 running ] [ 3, 4, 5, 6 waiting ]
-                ↓
-API:         [1] [2]  ← only 2 hit the API at once
-                ↓
-             [3] [4]  ← when 1,2 finish, 3,4 start
+npm install orangeslice
 ```
 
-**Agent never has to:**
-- Think about concurrency
-- Add `await sleep()`
-- Worry about rate limits
-- Handle API throttling errors
-
-## API Reference
+## API
 
 ### `orangeslice.b2b.sql<T>(query: string): Promise<T>`
 
-Execute SQL and return rows.
+Execute SQL and return rows. **Always wrap multiple calls in `Promise.all()`.**
 
 ```typescript
+// Single query
 const companies = await orangeslice.b2b.sql<Company[]>(
   "SELECT * FROM linkedin_company WHERE employee_count > 1000 LIMIT 10"
 );
+
+// Multiple queries - ALWAYS parallel
+const [techCos, healthCos, financeCos] = await Promise.all([
+  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE industry_code = 4 LIMIT 10"),
+  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE industry_code = 14 LIMIT 10"),
+  orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE industry_code = 43 LIMIT 10"),
+]);
 ```
 
 ### `orangeslice.b2b.query<T>(query: string): Promise<QueryResult<T>>`
@@ -164,42 +113,19 @@ const result = await orangeslice.b2b.query("SELECT * FROM linkedin_company LIMIT
 // result.rows, result.rowCount, result.duration_ms
 ```
 
-### `orangeslice.serp.search(query: string, options?): Promise<SerpResponse>`
+### `orangeslice.b2b.configure(options)`
 
-Search Google and return results.
+Configure rate limiting. Default settings handle parallelization automatically.
 
 ```typescript
-const response = await orangeslice.serp.search("Stripe funding 2024");
-// response.results = [{ title, link, snippet }, ...]
-
-// With options
-const filtered = await orangeslice.serp.search("site:linkedin.com CEO", {
-  tbs: "qdr:m",  // Past month
-  page: 1
+orangeslice.b2b.configure({
+  concurrency: 3,      // default: 2 concurrent requests
+  minDelayMs: 200,     // default: 100ms between requests
 });
 ```
 
-### `orangeslice.firecrawl.scrape(url: string, limit?): Promise<FirecrawlResponse>`
-
-Scrape a website and get markdown + social URLs.
-
-```typescript
-const page = await orangeslice.firecrawl.scrape("https://stripe.com/about");
-// page.markdown, page.socialUrls
-```
-
-### `orangeslice.browser.execute(code: string, options?): Promise<BrowserResponse>`
-
-Execute Playwright code with `page` in scope.
-
-```typescript
-const response = await orangeslice.browser.execute(`
-  await page.goto("https://example.com", { waitUntil: 'domcontentloaded' });
-  return await page.evaluate(() => document.title);
-`);
-// response.success, response.result
-```
-
-## Note on Concurrency
+## Restrictions
 
-The rate limit is **per-process**. If you run multiple scripts simultaneously, each has its own queue. For most AI agent use cases (single script), this is fine.
+- No direct contact data (email/phone)
+- No Indeed job board data
+- No traffic/analytics data

package/dist/cli.js

@@ -59,7 +59,8 @@ function copyDirSync(src, dest) {
     }
 }
 async function main() {
-    console.log("\n🍊 orangeslice - setting up AI sales agent toolkit\n");
+    console.log("\n🍊 orangeslice - B2B LinkedIn Database Prospector\n");
+    console.log("   Your AI agent's sole job: understand this database and answer queries.\n");
     // 1. Copy AGENTS.md to project root (for auto-detection by Claude Code, etc.)
     console.log("1. Installing AGENTS.md at project root...");
     if (fs.existsSync(AGENTS_MD)) {
@@ -67,7 +68,7 @@ async function main() {
         console.log("   ✓ AGENTS.md → ./AGENTS.md (auto-detected by AI agents)\n");
     }
     // 2. Copy full docs to orangeslice-docs/ (wipe existing to ensure clean state)
-    console.log("2. Copying tool documentation...");
+    console.log("2. Copying database documentation...");
     if (fs.existsSync(TARGET_DIR)) {
         fs.rmSync(TARGET_DIR, { recursive: true, force: true });
     }
@@ -83,15 +84,13 @@ async function main() {
             fs.copyFileSync(src, dest);
         }
     }
-    console.log(`   ✓ ${entries.length} items → ./orangeslice-docs/\n`);
-    console.log("   Docs created:");
-    console.log("   • AGENTS.md       - Main overview + quick APIs");
-    console.log("   • linkedin_data/  - Full schema + query examples");
-    console.log("   • b2b.md          - LinkedIn database (1B+ profiles)");
-    console.log("   • serp.md         - Google dorking cheatsheet");
-    console.log("   • browser.md      - Playwright automation");
-    console.log("   • apify.md        - Pre-built web scrapers");
-    console.log("   • strategies.md   - Prospecting & enrichment patterns\n");
+    console.log(`   ✓ Docs → ./orangeslice-docs/\n`);
+    console.log("   Documentation:");
+    console.log("   • AGENTS.md              - Agent instructions");
+    console.log("   • linkedin_data/         - Full database schema + query examples");
+    console.log("     ├── QUICK_REF.md       - START HERE: Critical rules & patterns");
+    console.log("     ├── tables/            - Table schemas (denormalized + normalized)");
+    console.log("     └── search_examples/   - Query patterns for people & companies\n");
     // 3. Install package
     console.log("3. Installing orangeslice package...");
     try {
@@ -101,15 +100,18 @@ async function main() {
         console.log("   (skipped - no package.json or npm not available)\n");
     }
     // 4. Done
-    console.log("\n✅ Done! Your AI agent is now a sales research assistant.\n");
-    console.log("   AGENTS.md at project root - Claude Code will auto-detect it.\n");
-    console.log("   Available tools:\n");
-    console.log("   • orangeslice.b2b.sql()           - 1B+ LinkedIn profiles");
-    console.log("   • orangeslice.serp.search()       - Google Search");
-    console.log("   • orangeslice.firecrawl.scrape()  - Static web scraping");
-    console.log("   • orangeslice.browser.execute()   - Playwright automation");
-    console.log("   • orangeslice.generateObject()    - AI structured output");
-    console.log("   • orangeslice.apify.run()         - Pre-built scrapers");
-    console.log("   • orangeslice.geo.parseAddress()  - Geocoding\n");
+    console.log("\n✅ Done! Your AI agent is now a B2B LinkedIn database prospector.\n");
+    console.log("   Database: 1.15B profiles, 85M companies\n");
+    console.log("   ⚠️  CRITICAL RULE: ALWAYS PARALLELIZE QUERIES\n");
+    console.log("   // ❌ WRONG - Sequential");
+    console.log("   const a = await orangeslice.b2b.sql('...');");
+    console.log("   const b = await orangeslice.b2b.sql('...');\n");
+    console.log("   // ✅ CORRECT - Parallel");
+    console.log("   const [a, b] = await Promise.all([");
+    console.log("     orangeslice.b2b.sql('...'),");
+    console.log("     orangeslice.b2b.sql('...'),");
+    console.log("   ]);\n");
+    console.log("   The API handles rate limiting. Fire all queries at once.\n");
+    console.log("   Read linkedin_data/QUICK_REF.md before writing queries.\n");
 }
 main().catch(console.error);

package/dist/index.d.ts

@@ -1,45 +1,23 @@
 import { b2b } from "./b2b";
-import { serp } from "./serp";
-import { firecrawl } from "./firecrawl";
-import { browser } from "./browser";
-import { generateObject } from "./generateObject";
-import { apify } from "./apify";
-import { geo } from "./geo";
-export { b2b, serp, firecrawl, browser, generateObject, apify, geo };
+export { b2b };
 /**
- * Main orangeslice namespace - AI sales agent toolkit
+ * orangeslice - B2B LinkedIn Database
  *
  * @example
  * import { orangeslice } from 'orangeslice';
  *
- * // B2B Database - 1B+ LinkedIn profiles
+ * // Query 1B+ LinkedIn profiles
  * const companies = await orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE domain = 'stripe.com'");
  *
- * // Google Search
- * const results = await orangeslice.serp.search("best CRM software 2024");
- *
- * // Website Scraping (static pages)
- * const page = await orangeslice.firecrawl.scrape("https://stripe.com/about");
- *
- * // Browser Automation (dynamic pages, Playwright)
- * const data = await orangeslice.browser.execute(`
- *   await page.goto("https://example.com", { waitUntil: 'domcontentloaded' });
- *   return await page.evaluate(() => document.title);
+ * // Find people at a company
+ * const people = await orangeslice.b2b.sql(`
+ *   SELECT p.first_name, p.last_name, pos.title
+ *   FROM linkedin_profile p
+ *   JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = p.id
+ *   JOIN linkedin_company c ON c.id = pos.linkedin_company_id
+ *   WHERE c.domain = 'stripe.com' AND pos.end_date IS NULL
+ *   LIMIT 10
  * `);
- *
- * // AI Structured Output
- * const extracted = await orangeslice.generateObject.generate({
- *   prompt: "Extract company info from: Apple was founded in 1976",
- *   schema: { type: "object", properties: { name: { type: "string" }, year: { type: "number" } } }
- * });
- *
- * // Apify Actors (web scrapers)
- * const reviews = await orangeslice.apify.run("compass/crawler-google-places", { searchStringsArray: ["cafes NYC"] });
- *
- * // Geocoding
- * const location = await orangeslice.geo.parseAddress("1600 Amphitheatre Parkway, Mountain View, CA");
- *
- * // All calls are automatically rate-limited and queued
  */
 export declare const orangeslice: {
     b2b: {
@@ -47,33 +25,5 @@ export declare const orangeslice: {
         query: typeof import("./b2b").query;
         configure: typeof import("./b2b").configure;
     };
-    serp: {
-        search: typeof import("./serp").search;
-        organic: typeof import("./serp").organic;
-    };
-    firecrawl: {
-        scrape: typeof import("./firecrawl").scrape;
-        markdown: typeof import("./firecrawl").markdown;
-        socials: typeof import("./firecrawl").socials;
-    };
-    browser: {
-        execute: typeof import("./browser").execute;
-        snapshot: typeof import("./browser").snapshot;
-        text: typeof import("./browser").text;
-    };
-    generateObject: {
-        generate: typeof import("./generateObject").generate;
-        extract: typeof import("./generateObject").extract;
-    };
-    apify: {
-        run: typeof import("./apify").run;
-        search: typeof import("./apify").search;
-        getInputSchema: typeof import("./apify").getInputSchema;
-    };
-    geo: {
-        parseAddress: typeof import("./geo").parseAddress;
-        geocode: typeof import("./geo").geocode;
-        getCityState: typeof import("./geo").getCityState;
-    };
 };
 export default orangeslice;

package/dist/index.js

@@ -1,62 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.orangeslice = exports.geo = exports.apify = exports.generateObject = exports.browser = exports.firecrawl = exports.serp = exports.b2b = void 0;
+exports.orangeslice = exports.b2b = void 0;
 const b2b_1 = require("./b2b");
 Object.defineProperty(exports, "b2b", { enumerable: true, get: function () { return b2b_1.b2b; } });
-const serp_1 = require("./serp");
-Object.defineProperty(exports, "serp", { enumerable: true, get: function () { return serp_1.serp; } });
-const firecrawl_1 = require("./firecrawl");
-Object.defineProperty(exports, "firecrawl", { enumerable: true, get: function () { return firecrawl_1.firecrawl; } });
-const browser_1 = require("./browser");
-Object.defineProperty(exports, "browser", { enumerable: true, get: function () { return browser_1.browser; } });
-const generateObject_1 = require("./generateObject");
-Object.defineProperty(exports, "generateObject", { enumerable: true, get: function () { return generateObject_1.generateObject; } });
-const apify_1 = require("./apify");
-Object.defineProperty(exports, "apify", { enumerable: true, get: function () { return apify_1.apify; } });
-const geo_1 = require("./geo");
-Object.defineProperty(exports, "geo", { enumerable: true, get: function () { return geo_1.geo; } });
 /**
- * Main orangeslice namespace - AI sales agent toolkit
+ * orangeslice - B2B LinkedIn Database
  *
  * @example
  * import { orangeslice } from 'orangeslice';
  *
- * // B2B Database - 1B+ LinkedIn profiles
+ * // Query 1B+ LinkedIn profiles
  * const companies = await orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE domain = 'stripe.com'");
  *
- * // Google Search
- * const results = await orangeslice.serp.search("best CRM software 2024");
- *
- * // Website Scraping (static pages)
- * const page = await orangeslice.firecrawl.scrape("https://stripe.com/about");
- *
- * // Browser Automation (dynamic pages, Playwright)
- * const data = await orangeslice.browser.execute(`
- *   await page.goto("https://example.com", { waitUntil: 'domcontentloaded' });
- *   return await page.evaluate(() => document.title);
+ * // Find people at a company
+ * const people = await orangeslice.b2b.sql(`
+ *   SELECT p.first_name, p.last_name, pos.title
+ *   FROM linkedin_profile p
+ *   JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = p.id
+ *   JOIN linkedin_company c ON c.id = pos.linkedin_company_id
+ *   WHERE c.domain = 'stripe.com' AND pos.end_date IS NULL
+ *   LIMIT 10
  * `);
- *
- * // AI Structured Output
- * const extracted = await orangeslice.generateObject.generate({
- *   prompt: "Extract company info from: Apple was founded in 1976",
- *   schema: { type: "object", properties: { name: { type: "string" }, year: { type: "number" } } }
- * });
- *
- * // Apify Actors (web scrapers)
- * const reviews = await orangeslice.apify.run("compass/crawler-google-places", { searchStringsArray: ["cafes NYC"] });
- *
- * // Geocoding
- * const location = await orangeslice.geo.parseAddress("1600 Amphitheatre Parkway, Mountain View, CA");
- *
- * // All calls are automatically rate-limited and queued
  */
 exports.orangeslice = {
     b2b: b2b_1.b2b,
-    serp: serp_1.serp,
-    firecrawl: firecrawl_1.firecrawl,
-    browser: browser_1.browser,
-    generateObject: generateObject_1.generateObject,
-    apify: apify_1.apify,
-    geo: geo_1.geo,
 };
 exports.default = exports.orangeslice;