orangeslice 1.8.6-beta.0 → 2.0.0

package/dist/api.d.ts

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

package/dist/api.js

@@ -3,13 +3,14 @@ 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 DEFAULT_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)
@@ -18,7 +19,7 @@ function configure(opts) {
         _config.baseUrl = opts.baseUrl;
 }
 function resolveBaseUrl() {
-    return _config.baseUrl || process.env.ORANGESLICE_BASE_URL || DEFAULT_BASE_URL;
+    return (_config.baseUrl || process.env.ORANGESLICE_BASE_URL || DEFAULT_BASE_URL).replace(/\/+$/, "");
 }
 function resolveApiKey() {
     return _config.apiKey || process.env.ORANGESLICE_API_KEY || "";
@@ -65,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" });
@@ -88,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
@@ -105,26 +102,25 @@ 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 = {}) {
-    void options;
+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}?functionId=${functionId}`;
-    const body = JSON.stringify(payload);
+    const url = `${baseUrl}${endpoint}`;
+    const body = JSON.stringify({ ...payload, inlineWaitMs: DEFAULT_INLINE_WAIT_MS });
     const headers = {
         "Content-Type": "application/json",
         Authorization: `Bearer ${apiKey}`
@@ -135,18 +131,17 @@ async function post(functionId, payload, options = {}) {
         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/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/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/prospecting/index.md

@@ -216,17 +216,31 @@ type search = (params: {
 }>;
 ```
 
-## Prospecting Continuation Trigger (Get More Leads)
+## Create Useful Views After Prospecting
 
-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.
+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.
 
-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
+Use `ctx.sql()` with `CREATE VIEW ... ON ... AS SELECT ...`.
 
-Only skip this when the user explicitly says they do not want a continuation trigger.
+**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/package.json

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