orangeslice 1.7.9 → 1.7.10

package/README.md

@@ -16,6 +16,7 @@ Your AI agent gets:
 - Anti-patterns to avoid
 - Performance rules
 - **Parallelization patterns** — agents must run queries in parallel, never sequentially
+- **AI structured output** — extract structured data from text with `orangeslice.ai.generateObject()`
 
 ## 🚨 CRITICAL: Always Parallelize
 
@@ -124,6 +125,38 @@ orangeslice.b2b.configure({
 });
 ```
 
+### `orangeslice.ai.generateObject<T>(options): Promise<T>`
+
+Generate structured data from text using AI.
+
+```typescript
+const result = await orangeslice.ai.generateObject({
+  prompt: "Extract company info: Stripe was founded in 2010 by Patrick Collison",
+  schema: {
+    type: "object",
+    properties: {
+      company: { type: "string" },
+      year: { type: "number" },
+      founder: { type: "string" }
+    },
+    required: ["company", "year"]
+  }
+});
+// { company: "Stripe", year: 2010, founder: "Patrick Collison" }
+```
+
+### `orangeslice.ai.extract<T>(text, schema, instructions?): Promise<T>`
+
+Convenience method to extract structured data from text.
+
+```typescript
+const data = await orangeslice.ai.extract(
+  "Apple Inc was founded in 1976 by Steve Jobs in Cupertino",
+  { type: "object", properties: { company: { type: "string" }, year: { type: "number" } } },
+  "Extract the company name and founding year"
+);
+```
+
 ## Restrictions
 
 - No direct contact data (email/phone)

package/dist/ai.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Configure the AI client
+ */
+export declare function configure(options: {
+    proxyUrl?: string;
+    concurrency?: number;
+    minDelayMs?: number;
+}): void;
+export interface JsonSchema {
+    type: "object" | "array" | "string" | "number" | "boolean";
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    description?: string;
+    enum?: (string | number)[];
+}
+export interface GenerateObjectOptions {
+    prompt: string;
+    schema: JsonSchema;
+    system?: string;
+}
+/**
+ * Generate a structured object from a prompt using AI.
+ * Automatically rate-limited and concurrency-controlled.
+ *
+ * @example
+ * const result = await ai.generateObject({
+ *   prompt: "Extract company info: Apple Inc was founded in 1976 by Steve Jobs",
+ *   schema: {
+ *     type: "object",
+ *     properties: {
+ *       company: { type: "string" },
+ *       year: { type: "number" },
+ *       founder: { type: "string" }
+ *     },
+ *     required: ["company", "year"]
+ *   }
+ * });
+ * // { company: "Apple Inc", year: 1976, founder: "Steve Jobs" }
+ */
+export declare function generateObject<T = unknown>(options: GenerateObjectOptions): Promise<T>;
+/**
+ * Convenience method to extract structured data from text.
+ *
+ * @example
+ * const data = await ai.extract(
+ *   "Apple Inc was founded in 1976 by Steve Jobs in Cupertino",
+ *   { type: "object", properties: { company: { type: "string" }, year: { type: "number" } } },
+ *   "Extract the company name and founding year"
+ * );
+ */
+export declare function extract<T = unknown>(text: string, schema: JsonSchema, instructions?: string): Promise<T>;
+export declare const ai: {
+    generateObject: typeof generateObject;
+    extract: typeof extract;
+    configure: typeof configure;
+};

package/dist/ai.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ai = void 0;
+exports.configure = configure;
+exports.generateObject = generateObject;
+exports.extract = extract;
+const queue_1 = require("./queue");
+// Default config
+let config = {
+    proxyUrl: process.env.ORANGESLICE_AI_URL || "https://orangeslice.ai/api/function?functionId=generateObject",
+    concurrency: 10,
+    minDelayMs: 10, // 10ms between requests = max 100/sec
+};
+// Create queue and rate limiter with defaults
+let queue = (0, queue_1.createQueue)(config.concurrency);
+let rateLimiter = (0, queue_1.createRateLimiter)(config.minDelayMs);
+/**
+ * Configure the AI client
+ */
+function configure(options) {
+    if (options.proxyUrl)
+        config.proxyUrl = options.proxyUrl;
+    if (options.concurrency) {
+        config.concurrency = options.concurrency;
+        queue = (0, queue_1.createQueue)(options.concurrency);
+    }
+    if (options.minDelayMs !== undefined) {
+        config.minDelayMs = options.minDelayMs;
+        rateLimiter = (0, queue_1.createRateLimiter)(options.minDelayMs);
+    }
+}
+/**
+ * Generate a structured object from a prompt using AI.
+ * Automatically rate-limited and concurrency-controlled.
+ *
+ * @example
+ * const result = await ai.generateObject({
+ *   prompt: "Extract company info: Apple Inc was founded in 1976 by Steve Jobs",
+ *   schema: {
+ *     type: "object",
+ *     properties: {
+ *       company: { type: "string" },
+ *       year: { type: "number" },
+ *       founder: { type: "string" }
+ *     },
+ *     required: ["company", "year"]
+ *   }
+ * });
+ * // { company: "Apple Inc", year: 1976, founder: "Steve Jobs" }
+ */
+async function generateObject(options) {
+    return queue(async () => {
+        return rateLimiter(async () => {
+            const response = await fetch(config.proxyUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(options),
+            });
+            if (!response.ok) {
+                throw new Error(`AI generateObject request failed: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            if (data.error) {
+                throw new Error(`AI generateObject error: ${data.error}`);
+            }
+            return data.result;
+        });
+    });
+}
+/**
+ * Convenience method to extract structured data from text.
+ *
+ * @example
+ * const data = await ai.extract(
+ *   "Apple Inc was founded in 1976 by Steve Jobs in Cupertino",
+ *   { type: "object", properties: { company: { type: "string" }, year: { type: "number" } } },
+ *   "Extract the company name and founding year"
+ * );
+ */
+async function extract(text, schema, instructions) {
+    const prompt = instructions ? `${instructions}\n\nText:\n${text}` : `Extract structured data from the following text:\n\n${text}`;
+    return generateObject({ prompt, schema });
+}
+// Export as namespace
+exports.ai = {
+    generateObject,
+    extract,
+    configure,
+};

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { b2b } from "./b2b";
-export { b2b };
+import { ai } from "./ai";
+export { b2b, ai };
 /**
- * orangeslice - B2B LinkedIn Database
+ * orangeslice - B2B LinkedIn Database + AI
  *
  * @example
  * import { orangeslice } from 'orangeslice';
@@ -9,15 +10,11 @@ export { b2b };
  * // Query 1B+ LinkedIn profiles
  * const companies = await orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE domain = 'stripe.com'");
  *
- * // 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
- * `);
+ * // Generate structured data with AI
+ * const extracted = await orangeslice.ai.generateObject({
+ *   prompt: "Extract company info: Apple was founded in 1976",
+ *   schema: { type: "object", properties: { name: { type: "string" }, year: { type: "number" } } }
+ * });
  */
 export declare const orangeslice: {
     b2b: {
@@ -25,5 +22,10 @@ export declare const orangeslice: {
         query: typeof import("./b2b").query;
         configure: typeof import("./b2b").configure;
     };
+    ai: {
+        generateObject: typeof import("./ai").generateObject;
+        extract: typeof import("./ai").extract;
+        configure: typeof import("./ai").configure;
+    };
 };
 export default orangeslice;

package/dist/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.orangeslice = exports.b2b = void 0;
+exports.orangeslice = exports.ai = exports.b2b = void 0;
 const b2b_1 = require("./b2b");
 Object.defineProperty(exports, "b2b", { enumerable: true, get: function () { return b2b_1.b2b; } });
+const ai_1 = require("./ai");
+Object.defineProperty(exports, "ai", { enumerable: true, get: function () { return ai_1.ai; } });
 /**
- * orangeslice - B2B LinkedIn Database
+ * orangeslice - B2B LinkedIn Database + AI
  *
  * @example
  * import { orangeslice } from 'orangeslice';
@@ -12,17 +14,14 @@ Object.defineProperty(exports, "b2b", { enumerable: true, get: function () { ret
  * // Query 1B+ LinkedIn profiles
  * const companies = await orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE domain = 'stripe.com'");
  *
- * // 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
- * `);
+ * // Generate structured data with AI
+ * const extracted = await orangeslice.ai.generateObject({
+ *   prompt: "Extract company info: Apple was founded in 1976",
+ *   schema: { type: "object", properties: { name: { type: "string" }, year: { type: "number" } } }
+ * });
  */
 exports.orangeslice = {
     b2b: b2b_1.b2b,
+    ai: ai_1.ai,
 };
 exports.default = exports.orangeslice;

package/docs/AGENTS.md

@@ -46,6 +46,25 @@ const results = await Promise.all(
 - Work history, education, certifications, skills, funding data
 - Updated regularly
 
+## AI Structured Output
+
+Use `orangeslice.ai.generateObject()` to extract structured data from text:
+
+```typescript
+const result = await orangeslice.ai.generateObject({
+  prompt: "Extract company info: Stripe was founded in 2010 by Patrick Collison",
+  schema: {
+    type: "object",
+    properties: {
+      company: { type: "string" },
+      year: { type: "number" },
+      founder: { type: "string" }
+    }
+  }
+});
+// { company: "Stripe", year: 2010, founder: "Patrick Collison" }
+```
+
 ## Quick Start
 
 ```typescript

package/package.json

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