@predicatelabs/sdk 0.99.9

package/dist/llm-provider.js

@@ -0,0 +1,460 @@
+"use strict";
+/**
+ * LLM Provider Abstraction - BYOB (Bring Your Own Brain)
+ * Enables pluggable LLM support for SentienceAgent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiProvider = exports.GLMProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.LocalVisionLLMProvider = exports.LocalLLMProvider = exports.LLMProvider = void 0;
+/**
+ * Abstract base class for LLM providers
+ * Implement this to integrate any LLM (OpenAI, Anthropic, Local, etc.)
+ */
+class LLMProvider {
+    /**
+     * Whether this provider supports image input for vision tasks.
+     * Override in subclasses that support vision-capable models.
+     */
+    supportsVision() {
+        return false;
+    }
+    /**
+     * Generate with image input (vision-capable models only).
+     * Override in subclasses that support vision.
+     */
+    async generateWithImage(systemPrompt, userPrompt, imageBase64, options = {}) {
+        throw new Error(`${this.constructor.name} does not support vision. ` +
+            `Use a vision-capable provider (e.g., OpenAIProvider with GPT-4o, AnthropicProvider with Claude 3).`);
+    }
+}
+exports.LLMProvider = LLMProvider;
+/**
+ * Local OpenAI-compatible Provider (Ollama / LM Studio / llama.cpp server, etc.)
+ *
+ * This is the TypeScript equivalent of Python's LocalLLMProvider concept, but instead of
+ * embedding a full HF runtime inside Node, it calls a local HTTP server that exposes an
+ * OpenAI-compatible Chat Completions API.
+ *
+ * Examples of compatible local servers:
+ * - Ollama (OpenAI-compatible endpoint)
+ * - LM Studio (OpenAI-compatible endpoint)
+ * - llama.cpp server (OpenAI-compatible endpoint)
+ */
+class LocalLLMProvider extends LLMProvider {
+    constructor(options = {}) {
+        super();
+        this._modelName = options.model ?? process.env.SENTIENCE_LOCAL_LLM_MODEL ?? 'local-model';
+        // Common defaults:
+        // - Ollama OpenAI-compatible: http://localhost:11434/v1
+        // - LM Studio: http://localhost:1234/v1
+        this._baseUrl =
+            options.baseUrl ?? process.env.SENTIENCE_LOCAL_LLM_BASE_URL ?? 'http://localhost:11434/v1';
+        this._apiKey = options.apiKey ?? process.env.SENTIENCE_LOCAL_LLM_API_KEY;
+        this._timeoutMs = options.timeoutMs ?? 60000;
+        this._defaultHeaders = {
+            'Content-Type': 'application/json',
+            ...(options.headers ?? {}),
+        };
+        if (this._apiKey) {
+            this._defaultHeaders.Authorization = `Bearer ${this._apiKey}`;
+        }
+    }
+    supportsJsonMode() {
+        // Many local OpenAI-compatible servers don't reliably implement response_format=json_object.
+        return false;
+    }
+    get modelName() {
+        return this._modelName;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        const fetchFn = globalThis.fetch;
+        if (!fetchFn) {
+            throw new Error('Global fetch is not available. Use Node 18+ or polyfill fetch before using LocalLLMProvider.');
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeoutMs ?? this._timeoutMs);
+        const payload = {
+            model: this._modelName,
+            messages: [
+                ...(systemPrompt ? [{ role: 'system', content: systemPrompt }] : []),
+                { role: 'user', content: userPrompt },
+            ],
+            temperature: options.temperature ?? 0.0,
+        };
+        if (options.max_tokens !== undefined)
+            payload.max_tokens = options.max_tokens;
+        if (options.top_p !== undefined)
+            payload.top_p = options.top_p;
+        // Allow pass-through of server-specific fields, but avoid overriding core fields accidentally
+        const { timeoutMs: _ignoredTimeout, ...rest } = options;
+        Object.assign(payload, rest);
+        try {
+            const res = await fetchFn(`${this._baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: this._defaultHeaders,
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const text = await res.text();
+            if (!res.ok) {
+                throw new Error(`Local LLM HTTP ${res.status}: ${text.slice(0, 500)}`);
+            }
+            const data = JSON.parse(text);
+            const choice = data?.choices?.[0];
+            const content = choice?.message?.content ?? '';
+            const usage = data?.usage;
+            return {
+                content,
+                promptTokens: usage?.prompt_tokens,
+                completionTokens: usage?.completion_tokens,
+                totalTokens: usage?.total_tokens,
+                modelName: data?.model ?? this._modelName,
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+exports.LocalLLMProvider = LocalLLMProvider;
+/**
+ * Local OpenAI-compatible Vision Provider.
+ *
+ * This is the TypeScript analogue of Python's LocalVisionLLMProvider, but it assumes your
+ * local server supports the OpenAI vision message format (image_url with data: URI).
+ *
+ * If your local stack uses a different schema (e.g., Ollama images array), you can implement
+ * a custom provider by extending LLMProvider.
+ */
+class LocalVisionLLMProvider extends LocalLLMProvider {
+    supportsVision() {
+        return true;
+    }
+    async generateWithImage(systemPrompt, userPrompt, imageBase64, options = {}) {
+        const fetchFn = globalThis.fetch;
+        if (!fetchFn) {
+            throw new Error('Global fetch is not available. Use Node 18+ or polyfill fetch before using LocalVisionLLMProvider.');
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeoutMs ?? this._timeoutMs ?? 60000);
+        // Rebuild payload (we cannot reuse LocalLLMProvider.generate because message shape differs)
+        const modelName = this._modelName ?? 'local-model';
+        const baseUrl = this._baseUrl ?? 'http://localhost:11434/v1';
+        const headers = this._defaultHeaders ?? { 'Content-Type': 'application/json' };
+        const payload = {
+            model: modelName,
+            messages: [
+                ...(systemPrompt ? [{ role: 'system', content: systemPrompt }] : []),
+                {
+                    role: 'user',
+                    content: [
+                        { type: 'text', text: userPrompt },
+                        { type: 'image_url', image_url: { url: `data:image/png;base64,${imageBase64}` } },
+                    ],
+                },
+            ],
+            temperature: options.temperature ?? 0.0,
+        };
+        if (options.max_tokens !== undefined)
+            payload.max_tokens = options.max_tokens;
+        const { timeoutMs: _ignoredTimeout, ...rest } = options;
+        Object.assign(payload, rest);
+        try {
+            const res = await fetchFn(`${baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const text = await res.text();
+            if (!res.ok) {
+                throw new Error(`Local Vision LLM HTTP ${res.status}: ${text.slice(0, 500)}`);
+            }
+            const data = JSON.parse(text);
+            const choice = data?.choices?.[0];
+            const content = choice?.message?.content ?? '';
+            const usage = data?.usage;
+            return {
+                content,
+                promptTokens: usage?.prompt_tokens,
+                completionTokens: usage?.completion_tokens,
+                totalTokens: usage?.total_tokens,
+                modelName: data?.model ?? modelName,
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+exports.LocalVisionLLMProvider = LocalVisionLLMProvider;
+/**
+ * OpenAI Provider (GPT-4, GPT-4o, etc.)
+ * Requires: npm install openai
+ */
+class OpenAIProvider extends LLMProvider {
+    constructor(apiKey, model = 'gpt-4o') {
+        super();
+        // Lazy import to avoid requiring openai package if not used
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { OpenAI } = require('openai');
+            this.client = new OpenAI({ apiKey });
+        }
+        catch {
+            throw new Error('OpenAI package not installed. Run: npm install openai');
+        }
+        this._modelName = model;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        const response = await this.client.chat.completions.create({
+            model: this._modelName,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: userPrompt },
+            ],
+            temperature: options.temperature ?? 0.0,
+            ...options,
+        });
+        const choice = response.choices[0];
+        return {
+            content: choice.message.content || '',
+            promptTokens: response.usage?.prompt_tokens,
+            completionTokens: response.usage?.completion_tokens,
+            totalTokens: response.usage?.total_tokens,
+            modelName: this._modelName,
+        };
+    }
+    supportsJsonMode() {
+        return true;
+    }
+    supportsVision() {
+        return true;
+    }
+    async generateWithImage(systemPrompt, userPrompt, imageBase64, options = {}) {
+        const response = await this.client.chat.completions.create({
+            model: this._modelName,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                {
+                    role: 'user',
+                    content: [
+                        { type: 'text', text: userPrompt },
+                        { type: 'image_url', image_url: { url: `data:image/png;base64,${imageBase64}` } },
+                    ],
+                },
+            ],
+            temperature: options.temperature ?? 0.0,
+            ...options,
+        });
+        const choice = response.choices[0];
+        return {
+            content: choice.message.content || '',
+            promptTokens: response.usage?.prompt_tokens,
+            completionTokens: response.usage?.completion_tokens,
+            totalTokens: response.usage?.total_tokens,
+            modelName: this._modelName,
+        };
+    }
+    get modelName() {
+        return this._modelName;
+    }
+}
+exports.OpenAIProvider = OpenAIProvider;
+/**
+ * Anthropic Provider (Claude 3.5 Sonnet, etc.)
+ * Requires: npm install @anthropic-ai/sdk
+ */
+class AnthropicProvider extends LLMProvider {
+    constructor(apiKey, model = 'claude-3-5-sonnet-20241022') {
+        super();
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { Anthropic } = require('@anthropic-ai/sdk');
+            this.client = new Anthropic({ apiKey });
+        }
+        catch {
+            throw new Error('Anthropic SDK not installed. Run: npm install @anthropic-ai/sdk');
+        }
+        this._modelName = model;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        const response = await this.client.messages.create({
+            model: this._modelName,
+            max_tokens: options.max_tokens ?? 1024,
+            system: systemPrompt,
+            messages: [{ role: 'user', content: userPrompt }],
+            temperature: options.temperature ?? 0.0,
+            ...options,
+        });
+        const content = response.content[0].text;
+        return {
+            content,
+            promptTokens: response.usage?.input_tokens,
+            completionTokens: response.usage?.output_tokens,
+            totalTokens: (response.usage?.input_tokens || 0) + (response.usage?.output_tokens || 0),
+            modelName: this._modelName,
+        };
+    }
+    supportsJsonMode() {
+        // Claude supports structured output but not via "json_mode" flag
+        return false;
+    }
+    supportsVision() {
+        return true;
+    }
+    async generateWithImage(systemPrompt, userPrompt, imageBase64, options = {}) {
+        const response = await this.client.messages.create({
+            model: this._modelName,
+            max_tokens: options.max_tokens ?? 1024,
+            system: systemPrompt,
+            messages: [
+                {
+                    role: 'user',
+                    content: [
+                        { type: 'text', text: userPrompt },
+                        {
+                            type: 'image',
+                            source: {
+                                type: 'base64',
+                                media_type: options.media_type ?? 'image/png',
+                                data: imageBase64,
+                            },
+                        },
+                    ],
+                },
+            ],
+            temperature: options.temperature ?? 0.0,
+            ...options,
+        });
+        const content = response.content[0].text;
+        return {
+            content,
+            promptTokens: response.usage?.input_tokens,
+            completionTokens: response.usage?.output_tokens,
+            totalTokens: (response.usage?.input_tokens || 0) + (response.usage?.output_tokens || 0),
+            modelName: this._modelName,
+        };
+    }
+    get modelName() {
+        return this._modelName;
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+/**
+ * Zhipu AI GLM Provider (GLM-4, GLM-4-Plus, etc.)
+ *
+ * Requirements:
+ *   npm install zhipuai-sdk-nodejs-v4
+ */
+class GLMProvider extends LLMProvider {
+    constructor(apiKey, model = 'glm-4-plus') {
+        super();
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const ZhipuAI = require('zhipuai-sdk-nodejs-v4');
+            this.client = new ZhipuAI({ apiKey });
+        }
+        catch {
+            throw new Error('ZhipuAI SDK not installed. Run: npm install zhipuai-sdk-nodejs-v4');
+        }
+        this._modelName = model;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: userPrompt });
+        const response = await this.client.chat.completions.create({
+            model: this._modelName,
+            messages,
+            temperature: options.temperature ?? 0.0,
+            max_tokens: options.max_tokens,
+            ...options,
+        });
+        const choice = response.choices[0];
+        const usage = response.usage;
+        return {
+            content: choice.message?.content || '',
+            promptTokens: usage?.prompt_tokens,
+            completionTokens: usage?.completion_tokens,
+            totalTokens: usage?.total_tokens,
+            modelName: this._modelName,
+        };
+    }
+    supportsJsonMode() {
+        // GLM-4 models support JSON mode
+        return this._modelName.toLowerCase().includes('glm-4');
+    }
+    get modelName() {
+        return this._modelName;
+    }
+}
+exports.GLMProvider = GLMProvider;
+/**
+ * Google Gemini Provider (Gemini 2.0, Gemini 1.5 Pro, etc.)
+ *
+ * Requirements:
+ *   npm install @google/generative-ai
+ */
+class GeminiProvider extends LLMProvider {
+    constructor(apiKey, model = 'gemini-2.0-flash-exp') {
+        super();
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { GoogleGenerativeAI } = require('@google/generative-ai');
+            const genAI = new GoogleGenerativeAI(apiKey);
+            this.model = genAI.getGenerativeModel({ model });
+        }
+        catch {
+            throw new Error('Google Generative AI SDK not installed. Run: npm install @google/generative-ai');
+        }
+        this._modelName = model;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        // Combine system and user prompts (Gemini doesn't have separate system role in all versions)
+        const fullPrompt = systemPrompt ? `${systemPrompt}\n\n${userPrompt}` : userPrompt;
+        // Build generation config
+        const generationConfig = {
+            temperature: options.temperature ?? 0.0,
+        };
+        if (options.max_tokens) {
+            generationConfig.maxOutputTokens = options.max_tokens;
+        }
+        // Merge additional parameters
+        Object.assign(generationConfig, options);
+        // Call Gemini API
+        const result = await this.model.generateContent({
+            contents: [{ role: 'user', parts: [{ text: fullPrompt }] }],
+            generationConfig,
+        });
+        const response = result.response;
+        const content = response.text() || '';
+        // Extract token usage if available
+        let promptTokens;
+        let completionTokens;
+        let totalTokens;
+        if (response.usageMetadata) {
+            promptTokens = response.usageMetadata.promptTokenCount;
+            completionTokens = response.usageMetadata.candidatesTokenCount;
+            totalTokens = response.usageMetadata.totalTokenCount;
+        }
+        return {
+            content,
+            promptTokens,
+            completionTokens,
+            totalTokens,
+            modelName: this._modelName,
+        };
+    }
+    supportsJsonMode() {
+        // Gemini 1.5+ models support JSON mode via response_mime_type
+        const modelLower = this._modelName.toLowerCase();
+        return modelLower.includes('gemini-1.5') || modelLower.includes('gemini-2.0');
+    }
+    get modelName() {
+        return this._modelName;
+    }
+}
+exports.GeminiProvider = GeminiProvider;
+//# sourceMappingURL=llm-provider.js.map

package/dist/llm-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":"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"}

package/dist/ordinal.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Phase 3: Ordinal Intent Detection for Semantic Search
+ *
+ * This module provides functions to detect ordinal intent in natural language goals
+ * and select elements based on their position within groups.
+ *
+ * Ordinal operators supported:
+ * - Position-based: "first", "second", "third", "1st", "2nd", "3rd", etc.
+ * - Relative: "top", "bottom", "last", "next", "previous"
+ * - Numeric: "#1", "#2", "number 1", "item 3"
+ *
+ * @example
+ * ```typescript
+ * import { detectOrdinalIntent, selectByOrdinal } from 'sentience';
+ *
+ * const intent = detectOrdinalIntent("click the first search result");
+ * // { detected: true, kind: 'nth', n: 1 }
+ *
+ * const element = selectByOrdinal(elements, "x5-w2-h1", intent);
+ * ```
+ */
+import { Element } from './types';
+export type OrdinalKind = 'first' | 'last' | 'nth' | 'top_k' | 'next' | 'previous';
+export interface OrdinalIntent {
+    /** Whether ordinal intent was detected */
+    detected: boolean;
+    /** Type of ordinal intent */
+    kind?: OrdinalKind;
+    /** For "nth" kind: 1-indexed position (1=first, 2=second) */
+    n?: number;
+    /** For "top_k" kind: number of items */
+    k?: number;
+}
+/**
+ * Detect ordinal intent from a goal string.
+ *
+ * @param goal - Natural language goal (e.g., "click the first search result")
+ * @returns OrdinalIntent with detected=true if ordinal intent found
+ *
+ * @example
+ * ```typescript
+ * detectOrdinalIntent("click the first item")
+ * // { detected: true, kind: 'nth', n: 1 }
+ *
+ * detectOrdinalIntent("select the 3rd option")
+ * // { detected: true, kind: 'nth', n: 3 }
+ *
+ * detectOrdinalIntent("show top 5 results")
+ * // { detected: true, kind: 'top_k', k: 5 }
+ *
+ * detectOrdinalIntent("find the submit button")
+ * // { detected: false }
+ * ```
+ */
+export declare function detectOrdinalIntent(goal: string): OrdinalIntent;
+/**
+ * Select element(s) from a list based on ordinal intent.
+ *
+ * Uses the dominantGroupKey to filter to the "main content" group,
+ * then selects by group_index based on the ordinal intent.
+ *
+ * @param elements - List of elements with group_key and group_index populated
+ * @param dominantGroupKey - The most common group key (main content group)
+ * @param intent - Detected ordinal intent
+ * @param currentElementId - Current element ID (for next/previous navigation)
+ * @returns Single Element for nth/first/last, array of Elements for top_k, or null
+ *
+ * @example
+ * ```typescript
+ * const intent = { detected: true, kind: 'nth', n: 1 };
+ * const element = selectByOrdinal(elements, "x5-w2-h1", intent);
+ * // Returns element with group_key="x5-w2-h1" and group_index=0
+ * ```
+ */
+export declare function selectByOrdinal(elements: Element[], dominantGroupKey: string | null | undefined, intent: OrdinalIntent, currentElementId?: number): Element | Element[] | null;
+/**
+ * Boost the importance of elements matching ordinal intent.
+ *
+ * This is useful for integrating ordinal selection with existing
+ * importance-based ranking. Elements matching the ordinal intent
+ * get a significant importance boost.
+ *
+ * @param elements - List of elements (not modified)
+ * @param dominantGroupKey - The most common group key
+ * @param intent - Detected ordinal intent
+ * @param boostFactor - Amount to add to importance (default: 10000)
+ * @returns A new array with copies of elements, with boosted importance for matches
+ */
+export declare function boostOrdinalElements(elements: Element[], dominantGroupKey: string | null | undefined, intent: OrdinalIntent, boostFactor?: number): Element[];
+//# sourceMappingURL=ordinal.d.ts.map

package/dist/ordinal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinal.d.ts","sourceRoot":"","sources":["../src/ordinal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAwDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAqD/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,MAAM,EAAE,aAAa,EACrB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAmE5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,MAAM,EAAE,aAAa,EACrB,WAAW,GAAE,MAAc,GAC1B,OAAO,EAAE,CAsBX"}