orangeslice 1.8.6 → 2.0.0

package/dist/api.d.ts

@@ -1,5 +1,6 @@
-interface PostOptions {
-    direct?: boolean;
+export interface OrangesliceConfig {
+    apiKey?: string;
+    baseUrl?: string;
 }
-export declare function post<T>(functionId: string, payload: Record<string, unknown>, options?: PostOptions): Promise<T>;
-export {};
+export declare function configure(opts: OrangesliceConfig): void;
+export declare function post<T>(endpoint: string, payload: Record<string, unknown>): Promise<T>;

package/dist/api.js

@@ -1,14 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure = configure;
 exports.post = post;
 /**
- * Batch-only routing:
- * - Submit all calls to Railway batch-service /function
- * - Poll batch-service /function/result on pending responses
+ * Transport layer for orangeslice SDK.
+ * Calls batch-service execute routes directly with API key auth.
+ * Polls /function/result/:requestId for async operations.
  */
-const BASE_URL = "https://enrichly-production.up.railway.app/function";
+const DEFAULT_BASE_URL = "https://enrichly-production.up.railway.app";
 const POLL_TIMEOUT_MS = 600000;
 const DEFAULT_POLL_INTERVAL_MS = 1000;
+const DEFAULT_INLINE_WAIT_MS = 5000;
+const _config = {};
+function configure(opts) {
+    if (opts.apiKey !== undefined)
+        _config.apiKey = opts.apiKey;
+    if (opts.baseUrl !== undefined)
+        _config.baseUrl = opts.baseUrl;
+}
+function resolveBaseUrl() {
+    return (_config.baseUrl || process.env.ORANGESLICE_BASE_URL || DEFAULT_BASE_URL).replace(/\/+$/, "");
+}
+function resolveApiKey() {
+    return _config.apiKey || process.env.ORANGESLICE_API_KEY || "";
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -51,18 +66,14 @@ function isPendingResponse(body) {
         return false;
     return body.pending === true;
 }
-function resolveBatchPollUrl(baseUrl, pending) {
+function resolvePollUrl(baseUrl, pending) {
     if (pending.pollUrl) {
         return new URL(pending.pollUrl, baseUrl).toString();
     }
     if (!pending.requestId) {
         throw new Error("[orangeslice] pending response missing requestId");
     }
-    const url = new URL(baseUrl);
-    const basePath = url.pathname.replace(/\/function\/?$/, "");
-    url.pathname = `${basePath}/function/result/${pending.requestId}`.replace(/\/{2,}/g, "/");
-    url.search = "";
-    return url.toString();
+    return `${baseUrl}/function/result/${pending.requestId}`;
 }
 async function fetchWithRedirect(url, init) {
     let res = await fetch(url, { ...init, redirect: "manual" });
@@ -74,8 +85,8 @@ async function fetchWithRedirect(url, init) {
     }
     return res;
 }
-async function pollBatchUntilComplete(baseUrl, functionId, pending) {
-    const pollUrl = resolveBatchPollUrl(baseUrl, pending);
+async function pollUntilComplete(baseUrl, endpoint, pending) {
+    const pollUrl = resolvePollUrl(baseUrl, pending);
     const timeoutAt = Date.now() + POLL_TIMEOUT_MS;
     let pollAfterMs = typeof pending.pollAfterMs === "number" && pending.pollAfterMs > 0
         ? pending.pollAfterMs
@@ -91,40 +102,46 @@ async function pollBatchUntilComplete(baseUrl, functionId, pending) {
         }
         if (!res.ok) {
             const message = asErrorMessage(data) || JSON.stringify(data);
-            throw new Error(`[orangeslice] ${functionId}: ${res.status} ${message}`);
+            throw new Error(`[orangeslice] ${endpoint}: ${res.status} ${message}`);
         }
         const message = asErrorMessage(data);
         if (message) {
-            throw new Error(`[orangeslice] ${functionId}: ${message}`);
+            throw new Error(`[orangeslice] ${endpoint}: ${message}`);
         }
         return data;
     }
-    throw new Error(`[orangeslice] ${functionId}: polling timed out after ${POLL_TIMEOUT_MS}ms`);
+    throw new Error(`[orangeslice] ${endpoint}: polling timed out after ${POLL_TIMEOUT_MS}ms`);
 }
-async function post(functionId, payload, options = {}) {
-    // Kept for backwards compatibility with older call sites.
-    void options;
-    const baseUrl = BASE_URL;
-    const url = `${baseUrl}?functionId=${functionId}`;
-    const body = JSON.stringify(payload);
+async function post(endpoint, payload) {
+    const baseUrl = resolveBaseUrl();
+    const apiKey = resolveApiKey();
+    if (!apiKey) {
+        throw new Error("[orangeslice] No API key configured. " +
+            "Set ORANGESLICE_API_KEY in your environment or call configure({ apiKey: 'osk_...' }).");
+    }
+    const url = `${baseUrl}${endpoint}`;
+    const body = JSON.stringify({ ...payload, inlineWaitMs: DEFAULT_INLINE_WAIT_MS });
+    const headers = {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`
+    };
     const res = await fetchWithRedirect(url, {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers,
         body
     });
     if (!res.ok) {
-        let message = `${res.status}`;
         const data = await readResponseBody(res);
-        message = asErrorMessage(data) || (typeof data === "string" ? data : JSON.stringify(data));
-        throw new Error(`[orangeslice] ${functionId}: ${res.status} ${message}`);
+        const message = asErrorMessage(data) || (typeof data === "string" ? data : JSON.stringify(data));
+        throw new Error(`[orangeslice] ${endpoint}: ${res.status} ${message}`);
     }
     const data = await readResponseBody(res);
     if (isPendingResponse(data)) {
-        return pollBatchUntilComplete(baseUrl, functionId, data);
+        return pollUntilComplete(baseUrl, endpoint, data);
     }
     const errorMessage = asErrorMessage(data);
     if (errorMessage) {
-        throw new Error(`[orangeslice] ${functionId}: ${errorMessage}`);
+        throw new Error(`[orangeslice] ${endpoint}: ${errorMessage}`);
     }
     return data;
 }

package/dist/apify.js

@@ -6,5 +6,5 @@ const api_1 = require("./api");
  * services.apify.runActor
  */
 async function runApifyActor(params) {
-    return (0, api_1.post)("apify", { ...params });
+    return (0, api_1.post)("/execute/apify", { ...params });
 }

package/dist/b2b.js

@@ -11,8 +11,7 @@ const api_1 = require("./api");
  * });
  */
 async function linkedinSearch(params) {
-    // LinkedIn SQL should hit the direct function backend, not the queue proxy.
-    const data = await (0, api_1.post)("b2b", { ...params }, { direct: true });
+    const data = await (0, api_1.post)("/execute/sql", { sql: params.sql });
     return {
         rows: data.rows ?? [],
         rowCount: data.rowCount ?? 0,

package/dist/browser.js

@@ -6,5 +6,5 @@ const api_1 = require("./api");
  * services.browser.execute
  */
 async function browserExecute(params) {
-    return (0, api_1.post)("kernel", { ...params });
+    return (0, api_1.post)("/execute/kernel", { ...params });
 }

package/dist/cli.js

@@ -37,6 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
 const LEGACY_DOCS_DIR = path.join(__dirname, "..", "docs");
 const TARGET_DIR = path.join(process.cwd(), "orangeslice-docs");
 const AGENTS_FILE = path.join(TARGET_DIR, "AGENTS.md");
@@ -110,6 +111,74 @@ function installOrangeslice(cwd) {
     console.log("  Installing orangeslice...");
     (0, child_process_1.execSync)("npm install orangeslice", { stdio: "inherit", cwd });
 }
+function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function readEnvFile(envPath) {
+    const entries = new Map();
+    if (!fs.existsSync(envPath))
+        return entries;
+    const lines = fs.readFileSync(envPath, "utf8").split("\n");
+    for (const line of lines) {
+        const match = line.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)/);
+        if (match)
+            entries.set(match[1], match[2]);
+    }
+    return entries;
+}
+function writeEnvVar(envPath, key, value) {
+    const entries = readEnvFile(envPath);
+    entries.set(key, value);
+    const lines = [];
+    if (fs.existsSync(envPath)) {
+        const original = fs.readFileSync(envPath, "utf8").split("\n");
+        let replaced = false;
+        for (const line of original) {
+            const match = line.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)/);
+            if (match && match[1] === key) {
+                lines.push(`${key}=${value}`);
+                replaced = true;
+            }
+            else {
+                lines.push(line);
+            }
+        }
+        if (!replaced) {
+            if (lines.length > 0 && lines[lines.length - 1] !== "")
+                lines.push("");
+            lines.push(`${key}=${value}`);
+        }
+    }
+    else {
+        lines.push(`${key}=${value}`, "");
+    }
+    fs.writeFileSync(envPath, lines.join("\n"), "utf8");
+}
+async function setupApiKey(cwd) {
+    const envPath = path.join(cwd, ".env");
+    const existing = readEnvFile(envPath).get("ORANGESLICE_API_KEY");
+    if (existing) {
+        console.log(`  ✓ API key already configured in .env (${existing.slice(0, 12)}...)\n`);
+        return;
+    }
+    console.log("  API key required. Get one at: https://www.orangeslice.ai/dashboard/api-keys\n");
+    const key = await prompt("  Paste your API key (osk_...): ");
+    if (!key) {
+        console.log("\n  ⚠ Skipped. Set ORANGESLICE_API_KEY in .env or call configure({ apiKey }) before using the SDK.\n");
+        return;
+    }
+    if (!key.startsWith("osk_")) {
+        console.log("\n  ⚠ Key doesn't start with osk_ — saving anyway. Double-check it's correct.\n");
+    }
+    writeEnvVar(envPath, "ORANGESLICE_API_KEY", key);
+    console.log(`\n  ✓ API key saved to .env\n`);
+}
 async function main() {
     console.log("\norangeslice\n");
     const docsDir = resolveDocsDir();
@@ -124,29 +193,27 @@ async function main() {
     ensurePackageJson(cwd);
     installOrangeslice(cwd);
     console.log("  ✓ Package installed in current directory\n");
+    // API key setup
+    await setupApiKey(cwd);
     console.log("\nReady - services-style API\n");
-    console.log("  import { services } from 'orangeslice';\n");
+    console.log("  import { configure, services } from 'orangeslice';\n");
+    console.log("  // Option A: env var (loaded automatically from .env by your framework)");
+    console.log("  // ORANGESLICE_API_KEY=osk_... in .env\n");
+    console.log("  // Option B: programmatic");
+    console.log("  configure({ apiKey: 'osk_...' });\n");
     console.log("  Agent setup (do this first):");
     console.log("  Ask your agent to read:");
     console.log("    1) ./orangeslice-docs/AGENTS.md");
     console.log("    2) ./orangeslice-docs/services/index.md");
     console.log('  Then tell it: "Use these docs as source of truth for all orangeslice operations."\n');
-    console.log("  Routing note:");
-    console.log("    - all services submit to the batch-service /function endpoint");
-    console.log("    - pending jobs poll batch-service /function/result endpoints");
-    console.log("    - this package currently includes only batch-backed services\n");
     console.log("  // LinkedIn B2B SQL");
     console.log('  const { rows } = await services.company.linkedin.search({ sql: "SELECT * FROM linkedin_company LIMIT 10" });\n');
     console.log("  // Web search");
     console.log("  const page = await services.web.search({ query: 'best CRM software' });\n");
-    console.log("  // Batched web search");
-    console.log("  const pages = await services.web.batchSearch({ queries: [{ query: 'site:linkedin.com/in stripe' }] });\n");
     console.log("  // AI structured output");
     console.log("  const { object } = await services.ai.generateObject({ prompt: '...', schema: {...} });\n");
     console.log("  // Browser automation (Kernel)");
     console.log('  const browser = await services.browser.execute({ code: "return await page.title();" });\n');
-    console.log("  // Apify actor");
-    console.log("  const actor = await services.apify.runActor({ actor: 'apify/web-scraper', input: {} });\n");
     console.log("  Always parallelize independent calls with Promise.all.\n");
 }
 main().catch(console.error);

package/dist/expansion.d.ts

@@ -61,17 +61,8 @@ export interface PersonContactGetResult {
 }
 export declare function personLinkedinEnrich(params: Record<string, unknown>): Promise<unknown>;
 export declare function companyLinkedinEnrich(params: Record<string, unknown>): Promise<unknown>;
-/**
- * Find a LinkedIn person profile URL from name/title/company context.
- */
 export declare function personLinkedinFindUrl(params: PersonLinkedinFindUrlParams): Promise<string | null>;
-/**
- * Find a LinkedIn company URL from website/company context.
- */
 export declare function companyLinkedinFindUrl(params: CompanyLinkedinFindUrlParams): Promise<string | null>;
-/**
- * Run contact waterfall through Inngest and poll until completion.
- */
 export declare function personContactGet(params: PersonContactGetParams): Promise<PersonContactGetResult>;
 export declare function companyGetEmployeesFromLinkedin(params: CompanyGetEmployeesFromLinkedinParams): Promise<CompanyGetEmployeesFromLinkedinResult>;
 export declare function geoParseAddress(params: Record<string, unknown>): Promise<unknown>;

package/dist/expansion.js

@@ -32,9 +32,6 @@ async function personLinkedinEnrich(params) {
     if (!url && !username) {
         throw new Error("[orangeslice] person.linkedin.enrich: provide url or username");
     }
-    // Root cause fix:
-    // Use indexed slug_key64 lookup first, then join into lkd_profile by profile_id.
-    // This avoids full scans/timeouts on lkd_profile slug filters.
     const sql = extended
         ? `SELECT lkd.*
          FROM linkedin_profile_slug ps
@@ -63,7 +60,7 @@ async function personLinkedinEnrich(params) {
          JOIN lkd_profile lkd ON lkd.profile_id = ps.linkedin_profile_id
          WHERE ps.slug_key64 = key64(${sqlString(username)})
          LIMIT 1`;
-    const data = await (0, api_1.post)("b2b", { sql }, { direct: true });
+    const data = await (0, api_1.post)("/execute/sql", { sql });
     return data.rows?.[0] ?? null;
 }
 async function companyLinkedinEnrich(params) {
@@ -85,41 +82,32 @@ async function companyLinkedinEnrich(params) {
         ? "*"
         : "name, slug, website, description, employee_count, follower_count, founded_year, locality, region, country_iso, country_name, type, size, ticker, specialties, linkedin_url, created_at, updated_at";
     const sql = `SELECT ${fields} FROM lkd_company WHERE ${where.join(" OR ")} LIMIT 1`;
-    const data = await (0, api_1.post)("b2b", { sql }, { direct: true });
+    const data = await (0, api_1.post)("/execute/sql", { sql });
     return data.rows?.[0] ?? null;
 }
-/**
- * Find a LinkedIn person profile URL from name/title/company context.
- */
 async function personLinkedinFindUrl(params) {
-    const url = await (0, api_1.post)("linkedinFindProfileUrl", params);
+    const url = await (0, api_1.post)("/execute/linkedin-find-profile-url", params);
     return typeof url === "string" && url.trim().length > 0 ? url : null;
 }
-/**
- * Find a LinkedIn company URL from website/company context.
- */
 async function companyLinkedinFindUrl(params) {
-    const url = await (0, api_1.post)("findLinkedinCompanyUrl", params);
+    const url = await (0, api_1.post)("/execute/find-linkedin-company-url", params);
     return typeof url === "string" && url.trim().length > 0 ? url : null;
 }
-/**
- * Run contact waterfall through Inngest and poll until completion.
- */
 async function personContactGet(params) {
-    return (0, api_1.post)("contactInfoWaterfall", { ...params });
+    return (0, api_1.post)("/execute/contact-waterfall", { ...params });
 }
 async function companyGetEmployeesFromLinkedin(params) {
-    return (0, api_1.post)("b2b-get-employees-for-company", params);
+    return (0, api_1.post)("/execute/b2b-company-employees", params);
 }
 async function geoParseAddress(params) {
-    return (0, api_1.post)("geo", params);
+    return (0, api_1.post)("/execute/parse-address", params);
 }
 async function builtWithLookupDomain(params) {
-    return (0, api_1.post)("builtwithLookupDomain", params);
+    return (0, api_1.post)("/execute/builtwith/lookup-domain", params);
 }
 async function builtWithRelationships(params) {
-    return (0, api_1.post)("builtwithRelationships", params);
+    return (0, api_1.post)("/execute/builtwith/relationships", params);
 }
 async function builtWithSearchByTech(params) {
-    return (0, api_1.post)("builtwithSearchByTech", params);
+    return (0, api_1.post)("/execute/builtwith/search-by-tech", params);
 }

package/dist/firecrawl.js

@@ -6,5 +6,20 @@ const api_1 = require("./api");
  * services.scrape.website
  */
 async function scrapeWebsite(params) {
-    return (0, api_1.post)("firecrawl", { ...params });
+    const p = params.params ?? {};
+    return (0, api_1.post)("/execute/firecrawl", {
+        url: params.url,
+        limit: p.limit ?? 1,
+        scrapeOptions: {
+            formats: ["markdown", "links"],
+            timeout: 30000,
+            skipTlsVerification: true,
+            onlyMainContent: false,
+            removeBase64Images: true,
+            blockAds: true,
+            storeInCache: true,
+            maxAge: 172800000,
+            ...p
+        }
+    });
 }

package/dist/generateObject.js

@@ -21,5 +21,9 @@ const api_1 = require("./api");
  * // { object: { company: "Apple Inc", year: 1976, founder: "Steve Jobs" } }
  */
 async function generateObject(options) {
-    return (0, api_1.post)("generateObject", { ...options });
+    return (0, api_1.post)("/execute/llm", {
+        mode: "object",
+        prompt: options.prompt,
+        schemaJson: options.schema
+    });
 }

package/dist/googleMaps.js

@@ -3,6 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.googleMapsScrape = googleMapsScrape;
 const api_1 = require("./api");
 async function googleMapsScrape(params) {
-    // Single path by design: use googleMaps function proxy only.
-    return (0, api_1.post)("googleMaps", { ...params });
+    return (0, api_1.post)("/execute/google-maps", { ...params });
 }

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { configure } from "./api";
+export type { OrangesliceConfig } from "./api";
 export { linkedinSearch } from "./b2b";
 export type { LinkedInSearchParams, LinkedInSearchResponse } from "./b2b";
 export { webSearch, webBatchSearch } from "./serp";
@@ -14,14 +16,14 @@ export { googleMapsScrape } from "./googleMaps";
 export type { GoogleMapsScrapeParams } from "./googleMaps";
 export { personLinkedinEnrich, personLinkedinFindUrl, personContactGet, companyLinkedinEnrich, companyLinkedinFindUrl, companyGetEmployeesFromLinkedin, geoParseAddress, builtWithLookupDomain, builtWithRelationships, builtWithSearchByTech } from "./expansion";
 export type { PersonLinkedinFindUrlParams, CompanyLinkedinFindUrlParams, PersonContactGetParams, PersonContactGetResult, CompanyGetEmployeesFromLinkedinParams, CompanyGetEmployeesFromLinkedinResult, CompanyEmployeeFromB2B } from "./expansion";
+import { runApifyActor } from "./apify";
 import { linkedinSearch } from "./b2b";
-import { webBatchSearch, webSearch } from "./serp";
-import { generateObject } from "./generateObject";
-import { scrapeWebsite } from "./firecrawl";
 import { browserExecute } from "./browser";
-import { runApifyActor } from "./apify";
-import { googleMapsScrape } from "./googleMaps";
 import { personLinkedinEnrich, personLinkedinFindUrl, personContactGet, companyLinkedinEnrich, companyLinkedinFindUrl, companyGetEmployeesFromLinkedin, geoParseAddress, builtWithLookupDomain, builtWithRelationships, builtWithSearchByTech } from "./expansion";
+import { scrapeWebsite } from "./firecrawl";
+import { generateObject } from "./generateObject";
+import { googleMapsScrape } from "./googleMaps";
+import { webBatchSearch, webSearch } from "./serp";
 export declare const services: {
     company: {
         linkedin: {

package/dist/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.services = exports.builtWithSearchByTech = exports.builtWithRelationships = exports.builtWithLookupDomain = exports.geoParseAddress = exports.companyGetEmployeesFromLinkedin = exports.companyLinkedinFindUrl = exports.companyLinkedinEnrich = exports.personContactGet = exports.personLinkedinFindUrl = exports.personLinkedinEnrich = exports.googleMapsScrape = exports.runApifyActor = exports.browserExecute = exports.scrapeWebsite = exports.generateObject = exports.webBatchSearch = exports.webSearch = exports.linkedinSearch = void 0;
+exports.services = exports.builtWithSearchByTech = exports.builtWithRelationships = exports.builtWithLookupDomain = exports.geoParseAddress = exports.companyGetEmployeesFromLinkedin = exports.companyLinkedinFindUrl = exports.companyLinkedinEnrich = exports.personContactGet = exports.personLinkedinFindUrl = exports.personLinkedinEnrich = exports.googleMapsScrape = exports.runApifyActor = exports.browserExecute = exports.scrapeWebsite = exports.generateObject = exports.webBatchSearch = exports.webSearch = exports.linkedinSearch = exports.configure = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return api_1.configure; } });
 var b2b_1 = require("./b2b");
 Object.defineProperty(exports, "linkedinSearch", { enumerable: true, get: function () { return b2b_1.linkedinSearch; } });
 var serp_1 = require("./serp");
@@ -27,14 +29,14 @@ Object.defineProperty(exports, "geoParseAddress", { enumerable: true, get: funct
 Object.defineProperty(exports, "builtWithLookupDomain", { enumerable: true, get: function () { return expansion_1.builtWithLookupDomain; } });
 Object.defineProperty(exports, "builtWithRelationships", { enumerable: true, get: function () { return expansion_1.builtWithRelationships; } });
 Object.defineProperty(exports, "builtWithSearchByTech", { enumerable: true, get: function () { return expansion_1.builtWithSearchByTech; } });
+const apify_2 = require("./apify");
 const b2b_2 = require("./b2b");
-const serp_2 = require("./serp");
-const generateObject_2 = require("./generateObject");
-const firecrawl_2 = require("./firecrawl");
 const browser_2 = require("./browser");
-const apify_2 = require("./apify");
-const googleMaps_2 = require("./googleMaps");
 const expansion_2 = require("./expansion");
+const firecrawl_2 = require("./firecrawl");
+const generateObject_2 = require("./generateObject");
+const googleMaps_2 = require("./googleMaps");
+const serp_2 = require("./serp");
 exports.services = {
     company: {
         linkedin: {

package/dist/serp.js

@@ -10,7 +10,7 @@ const api_1 = require("./api");
  * const page = await webSearch({ query: "best CRM software 2025" });
  */
 async function webSearch(params) {
-    return (0, api_1.post)("batchserp", { ...params });
+    return (0, api_1.post)("/execute/serp", { ...params });
 }
 /**
  * services.web.batchSearch
@@ -19,6 +19,8 @@ async function webSearch(params) {
  * const pages = await webBatchSearch({ queries: [{ query: "site:linkedin.com/in stripe" }] });
  */
 async function webBatchSearch(params) {
-    const data = await (0, api_1.post)("batchserp", { ...params });
+    const data = await (0, api_1.post)("/execute/serp-batch", {
+        queries: params.queries
+    });
     return Array.isArray(data) ? data : data.results ?? [];
 }

package/docs/integrations/gmail/index.md

@@ -0,0 +1,12 @@
+---
+description: Gmail email sending via Google integration
+---
+
+# Gmail Integration
+
+Typed functions for Gmail actions powered by Orange Slice Google integrations.
+
+## Email
+
+- `integrations.gmail.sendEmail(input)` - Send an email through the connected Gmail account
+- Heavy rate limit: `sendEmail` is capped at **20 calls/day** per connected Gmail account

package/docs/integrations/gmail/sendEmail.md

@@ -0,0 +1,51 @@
+# sendEmail
+
+Send an email from the connected Gmail account.
+
+> Rate limit note for AI: `integrations.gmail.sendEmail(...)` is heavily rate-limited to **20 calls/day** per connected Gmail account. Use sparingly and batch/aggregate where possible.
+
+```typescript
+// Basic email
+const result = await integrations.gmail.sendEmail({
+   recipient_email: "jane@example.com",
+   subject: "Hello from Orange Slice",
+   body: "Hi Jane, this is a test email."
+});
+
+// HTML email with additional recipients
+await integrations.gmail.sendEmail({
+   recipient_email: "primary@example.com",
+   extra_recipients: ["secondary@example.com"],
+   cc: ["manager@example.com"],
+   subject: "Weekly digest",
+   body: "<h3>Weekly Digest</h3><p>Everything looks good.</p>",
+   is_html: true
+});
+```
+
+## Input
+
+| Parameter          | Type        | Required | Description |
+| ------------------ | ----------- | -------- | ----------- |
+| `recipient_email`  | `string`    | No\*     | Primary `To` recipient |
+| `extra_recipients` | `string[]`  | No       | Additional `To` recipients |
+| `cc`               | `string[]`  | No       | CC recipients |
+| `bcc`              | `string[]`  | No       | BCC recipients |
+| `subject`          | `string`    | No\*     | Email subject |
+| `body`             | `string`    | No\*     | Email body (plain text or HTML) |
+| `is_html`          | `boolean`   | No       | Set to `true` when body is HTML |
+| `from_email`       | `string`    | No       | Optional verified send-as alias |
+| `attachment`       | `object`    | No       | Optional attachment payload |
+| `user_id`          | `string`    | No       | Gmail user id (`"me"` by default) |
+
+\*Gmail requires at least one recipient (`recipient_email`, `cc`, or `bcc`) and at least one of `subject` or `body`.
+
+## Output
+
+```typescript
+{
+  successful: boolean;
+  data?: unknown;
+  error?: string;
+}
+```

package/docs/integrations/index.md

@@ -148,3 +148,27 @@ const invite = await integrations.slack.conversationsInviteShared({
 ```
 
 See [slack/](./slack/) for all available functions.
+
+### Gmail
+
+Send emails from connected Google Gmail accounts.
+
+```typescript
+// Send a plain text email
+const result = await integrations.gmail.sendEmail({
+   recipient_email: "john@example.com",
+   subject: "Quick update",
+   body: "Hey John - sharing a quick status update."
+});
+
+// Send HTML with CC recipients
+await integrations.gmail.sendEmail({
+   recipient_email: "team@example.com",
+   cc: ["manager@example.com"],
+   subject: "Weekly summary",
+   body: "<h2>Weekly Summary</h2><p>All systems operational.</p>",
+   is_html: true
+});
+```
+
+See [gmail/](./gmail/) for available functions.

package/docs/prospecting/index.md

@@ -216,7 +216,31 @@ type search = (params: {
 }>;
 ```
 
----
+## Create Useful Views After Prospecting
+
+Once a prospecting workflow is set up, **always create a few views**. Views show up as colored tabs in the sheet bar so switching is instant.
+
+Use `ctx.sql()` with `CREATE VIEW ... ON ... AS SELECT ...`.
+
+**Prefer sorted views over filtered views.** A sorted view keeps ALL rows visible but groups the best ones at the top — the user sees qualified leads first and can scroll to see the rest. Filtered views hide rows, making it hard to judge how much work went into finding the qualified ones.
+
+```ts
+// Sorted view — qualified at top, rest below (preferred)
+await ctx.sql(
+   `CREATE VIEW "Best First" ON "Companies" AS SELECT * FROM "Companies" ORDER BY "Qualified" DESC, "Score" DESC`
+);
+
+// Sorted by score
+await ctx.sql(`CREATE VIEW "By Score" ON "Companies" AS SELECT * FROM "Companies" ORDER BY "Score" DESC`);
+
+// Grouped by category
+await ctx.sql(`CREATE VIEW "By Industry" ON "Companies" AS SELECT * FROM "Companies" ORDER BY "Industry" ASC`);
+
+// Only use WHERE filters for hard exclusions
+await ctx.sql(`CREATE VIEW "Errors Only" ON "Companies" AS SELECT * FROM "Companies" WHERE "Status" = 'failed'`);
+```
+
+Don't overthink it — just create 2-3 views that match the columns you built. Skip only if there's genuinely nothing to sort/group on.
 
 ## Examples
 

package/docs/services/ai/generateObject.ts

@@ -4,7 +4,7 @@
  * Generate an object using AI.
  * Does NOT have internet access.
  * IMPORTANT: Always incorporate the user's guidelines (i.e. no fabrication, writing style, format) into your prompt. See index.md.
- * You should take advantage of how specific zod can get here.
+ * Use a regular JSON schema object for `schema`.
  *
  * ⚠️ IMPORTANT: ONE CALL PER ITEM ⚠️
  * NEVER batch multiple items together and ask the AI to return an array of results.
@@ -21,7 +21,7 @@
 type generateObject = (params: {
    /** The prompt to generate the object from */
    prompt: string;
-   /** A Zod schema to generate the object from. must be z.object at the top level */
+   /** A JSON schema object describing the output shape */
    schema: any;
    /** Optional model override. All models currently route to gpt-5-mini */
    model?: "gpt-5-mini";

package/docs/services/person/contact/get.ts

@@ -16,6 +16,7 @@ interface ContactInfoResponse {
 /**
  * Get contact info (email, phone) for a person via LinkedIn URL or name+company.
  * This takes up to 10min. Returns work/personal/unknown variants prioritized in that order.
+ * If this is in a column, you should run it last as it takes a while.
  * CRITICAL: Never duplicate calls with identical params across columns.
  */
 type get = (params: {

package/docs/services/person/linkedin/enrich.md

@@ -94,6 +94,7 @@ interface B2BPersonExperience {
    company_name: string;
    company_domain: string | null;
    company_linkedin_url: string | null;
+   company_employee_count: number | null; // Employee count of the company
    locality: string | null; // City/region of the job
    start_date: string | null; // "YYYY-MM-DD"
    start_date_year: number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orangeslice",
-  "version": "1.8.6",
+  "version": "2.0.0",
   "description": "B2B LinkedIn database prospector - 1.15B profiles, 85M companies",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",