orangeslice 1.8.4 → 1.8.6-beta.0

package/dist/api.d.ts

@@ -1,3 +1,8 @@
+export interface OrangesliceConfig {
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare function configure(opts: OrangesliceConfig): void;
 interface PostOptions {
     direct?: boolean;
 }

package/dist/api.js

@@ -1,14 +1,28 @@
 "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
  */
-const BASE_URL = "https://enrichly-production.up.railway.app/function";
+const DEFAULT_BASE_URL = "https://enrichly-production.up.railway.app/function";
 const POLL_TIMEOUT_MS = 600000;
 const DEFAULT_POLL_INTERVAL_MS = 1000;
+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;
+}
+function resolveApiKey() {
+    return _config.apiKey || process.env.ORANGESLICE_API_KEY || "";
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -102,14 +116,22 @@ async function pollBatchUntilComplete(baseUrl, functionId, pending) {
     throw new Error(`[orangeslice] ${functionId}: 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 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}?functionId=${functionId}`;
     const body = JSON.stringify(payload);
+    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) {

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

@@ -28,8 +28,51 @@ export interface CompanyGetEmployeesFromLinkedinResult {
     nextPage: number | null;
     totalResults: number | null;
 }
+export interface PersonLinkedinFindUrlParams {
+    name?: string;
+    title?: string;
+    company?: string;
+    keyword?: string;
+    location?: string;
+}
+export interface CompanyLinkedinFindUrlParams {
+    companyName?: string;
+    website?: string;
+    location?: string;
+}
+export interface PersonContactGetParams {
+    linkedinUrl?: string;
+    required: Array<"email" | "work_email" | "phone">;
+    sources?: Array<"bcr">;
+    maxCoverage?: boolean;
+    domain?: string;
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    phoneNumber?: string;
+    userId?: string;
+}
+export interface PersonContactGetResult {
+    work_emails: string[];
+    work_phones: string[];
+    personal_emails: string[];
+    personal_phones: string[];
+    unknown_phones: string[];
+}
 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>;
 export declare function builtWithLookupDomain(params: Record<string, unknown>): Promise<unknown>;

package/dist/expansion.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.personLinkedinEnrich = personLinkedinEnrich;
 exports.companyLinkedinEnrich = companyLinkedinEnrich;
+exports.personLinkedinFindUrl = personLinkedinFindUrl;
+exports.companyLinkedinFindUrl = companyLinkedinFindUrl;
+exports.personContactGet = personContactGet;
 exports.companyGetEmployeesFromLinkedin = companyGetEmployeesFromLinkedin;
 exports.geoParseAddress = geoParseAddress;
 exports.builtWithLookupDomain = builtWithLookupDomain;
@@ -85,6 +88,26 @@ async function companyLinkedinEnrich(params) {
     const data = await (0, api_1.post)("b2b", { sql }, { direct: true });
     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);
+    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);
+    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 });
+}
 async function companyGetEmployeesFromLinkedin(params) {
     return (0, api_1.post)("b2b-get-employees-for-company", 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";
@@ -12,19 +14,20 @@ export { runApifyActor } from "./apify";
 export type { RunActorParams, RunActorResult, DatasetListParams } from "./apify";
 export { googleMapsScrape } from "./googleMaps";
 export type { GoogleMapsScrapeParams } from "./googleMaps";
-export { personLinkedinEnrich, companyLinkedinEnrich, companyGetEmployeesFromLinkedin, geoParseAddress, builtWithLookupDomain, builtWithRelationships, builtWithSearchByTech } from "./expansion";
-export type { CompanyGetEmployeesFromLinkedinParams, CompanyGetEmployeesFromLinkedinResult, CompanyEmployeeFromB2B } from "./expansion";
+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 { 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 { personLinkedinEnrich, companyLinkedinEnrich, companyGetEmployeesFromLinkedin, geoParseAddress, builtWithLookupDomain, builtWithRelationships, builtWithSearchByTech } from "./expansion";
+import { webBatchSearch, webSearch } from "./serp";
 export declare const services: {
     company: {
         linkedin: {
+            findUrl: typeof companyLinkedinFindUrl;
             enrich: typeof companyLinkedinEnrich;
             search: typeof linkedinSearch;
         };
@@ -32,9 +35,13 @@ export declare const services: {
     };
     person: {
         linkedin: {
+            findUrl: typeof personLinkedinFindUrl;
             enrich: typeof personLinkedinEnrich;
             search: typeof linkedinSearch;
         };
+        contact: {
+            get: typeof personContactGet;
+        };
     };
     web: {
         search: typeof webSearch;

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.companyLinkedinEnrich = 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");
@@ -18,23 +20,27 @@ var googleMaps_1 = require("./googleMaps");
 Object.defineProperty(exports, "googleMapsScrape", { enumerable: true, get: function () { return googleMaps_1.googleMapsScrape; } });
 var expansion_1 = require("./expansion");
 Object.defineProperty(exports, "personLinkedinEnrich", { enumerable: true, get: function () { return expansion_1.personLinkedinEnrich; } });
+Object.defineProperty(exports, "personLinkedinFindUrl", { enumerable: true, get: function () { return expansion_1.personLinkedinFindUrl; } });
+Object.defineProperty(exports, "personContactGet", { enumerable: true, get: function () { return expansion_1.personContactGet; } });
 Object.defineProperty(exports, "companyLinkedinEnrich", { enumerable: true, get: function () { return expansion_1.companyLinkedinEnrich; } });
+Object.defineProperty(exports, "companyLinkedinFindUrl", { enumerable: true, get: function () { return expansion_1.companyLinkedinFindUrl; } });
 Object.defineProperty(exports, "companyGetEmployeesFromLinkedin", { enumerable: true, get: function () { return expansion_1.companyGetEmployeesFromLinkedin; } });
 Object.defineProperty(exports, "geoParseAddress", { enumerable: true, get: function () { return expansion_1.geoParseAddress; } });
 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: {
+            findUrl: expansion_2.companyLinkedinFindUrl,
             enrich: expansion_2.companyLinkedinEnrich,
             search: b2b_2.linkedinSearch
         },
@@ -42,8 +48,12 @@ exports.services = {
     },
     person: {
         linkedin: {
+            findUrl: expansion_2.personLinkedinFindUrl,
             enrich: expansion_2.personLinkedinEnrich,
             search: b2b_2.linkedinSearch
+        },
+        contact: {
+            get: expansion_2.personContactGet
         }
     },
     web: {

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,6 +216,16 @@ type search = (params: {
 }>;
 ```
 
+## Prospecting Continuation Trigger (Get More Leads)
+
+For **every prospecting workflow**, aggressively default to creating a continuation trigger after the initial setup so the user can get more leads and run the workflow again without rebuilding anything.
+
+1. Read `triggers-runtime`
+2. Create or update a continuation trigger named `Get more <topic> leads` (fallback: `Get more leads`)
+3. Configure the trigger to continue the same prospecting strategy (next pages / additional query batches / source expansion) and run the workflow
+
+Only skip this when the user explicitly says they do not want a continuation trigger.
+
 ---
 
 ## Examples

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.4",
+  "version": "1.8.6-beta.0",
   "description": "B2B LinkedIn database prospector - 1.15B profiles, 85M companies",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",