@pga-ai/adapters-llm-perplexity 0.8.0

package/README.md

@@ -0,0 +1,43 @@
+# @pga-ai/adapters-llm-perplexity
+
+> Perplexity adapter for GSEP — web-search powered self-evolving agents
+
+Your agent can search the web in real-time while evolving its prompts.
+
+## Installation
+
+```bash
+npm install @pga-ai/core @pga-ai/adapters-llm-perplexity
+```
+
+## Usage
+
+```typescript
+import { PGA } from '@pga-ai/core';
+import { PerplexityAdapter } from '@pga-ai/adapters-llm-perplexity';
+
+const pga = new PGA({
+  llm: new PerplexityAdapter({
+    apiKey: process.env.PERPLEXITY_API_KEY!,
+    model: 'sonar-pro',
+  }),
+});
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | required | Perplexity API key |
+| `model` | `string` | `'sonar-pro'` | Model to use |
+| `temperature` | `number` | `0.7` | Temperature (0-2) |
+| `searchRecency` | `string` | — | Filter results: `'month'`, `'week'`, `'day'`, `'hour'` |
+
+## Supported Models
+
+- `sonar-pro` (recommended — best quality with web search)
+- `sonar` (fast with web search)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { LLMAdapter, Message, ChatOptions, ChatResponse, ChatChunk } from '@pga-ai/core';
+export interface PerplexityAdapterConfig {
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+    searchRecency?: string;
+}
+export declare class PerplexityAdapter implements LLMAdapter {
+    readonly name = "perplexity";
+    readonly model: string;
+    private client;
+    private config;
+    constructor(config: PerplexityAdapterConfig);
+    chat(messages: Message[], options?: ChatOptions): Promise<ChatResponse>;
+    stream(messages: Message[], options?: ChatOptions): AsyncIterableIterator<ChatChunk>;
+    estimateCost(messages: Message[]): Promise<number>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACR,UAAU,EACV,OAAO,EACP,WAAW,EACX,YAAY,EACZ,SAAS,EACZ,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,uBAAuB;IAIpC,MAAM,EAAE,MAAM,CAAC;IAMf,KAAK,CAAC,EAAE,MAAM,CAAC;IAMf,WAAW,CAAC,EAAE,MAAM,CAAC;IAMrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,uBAAuB;IAUrC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAuCtE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,qBAAqB,CAAC,SAAS,CAAC;IAiCrF,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAY3D"}

package/dist/index.js

@@ -0,0 +1,85 @@
+import OpenAI from 'openai';
+export class PerplexityAdapter {
+    name = 'perplexity';
+    model;
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.model = config.model || 'sonar-pro';
+        this.client = new OpenAI({
+            apiKey: config.apiKey,
+            baseURL: 'https://api.perplexity.ai',
+        });
+    }
+    async chat(messages, options) {
+        const openaiMessages = messages.map(m => ({
+            role: m.role,
+            content: m.content,
+        }));
+        try {
+            const response = await this.client.chat.completions.create({
+                model: this.model,
+                messages: openaiMessages,
+                temperature: options?.temperature ?? this.config.temperature ?? 0.7,
+                max_tokens: options?.maxTokens ?? 4096,
+                stream: false,
+            });
+            const choice = response.choices[0];
+            if (!choice) {
+                throw new Error('No response from Perplexity');
+            }
+            return {
+                content: choice.message.content || '',
+                usage: {
+                    inputTokens: response.usage?.prompt_tokens ?? 0,
+                    outputTokens: response.usage?.completion_tokens ?? 0,
+                },
+                metadata: {
+                    model: this.model,
+                    finishReason: choice.finish_reason || 'stop',
+                    citations: response.citations ?? [],
+                },
+            };
+        }
+        catch (error) {
+            throw new Error(`Perplexity API error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async *stream(messages, options) {
+        const openaiMessages = messages.map(m => ({
+            role: m.role,
+            content: m.content,
+        }));
+        try {
+            const stream = await this.client.chat.completions.create({
+                model: this.model,
+                messages: openaiMessages,
+                temperature: options?.temperature ?? this.config.temperature ?? 0.7,
+                max_tokens: options?.maxTokens ?? 4096,
+                stream: true,
+            });
+            for await (const chunk of stream) {
+                const delta = chunk.choices[0]?.delta;
+                if (!delta?.content) {
+                    if (chunk.choices[0]?.finish_reason) {
+                        yield { delta: '', done: true };
+                    }
+                    continue;
+                }
+                yield { delta: delta.content, done: false };
+            }
+        }
+        catch (error) {
+            throw new Error(`Perplexity streaming error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async estimateCost(messages) {
+        const totalChars = messages.reduce((sum, m) => sum + m.content.length, 0);
+        const estimatedTokens = Math.ceil(totalChars / 4);
+        const inputCost = (estimatedTokens * 0.7 * 3) / 1_000_000;
+        const outputCost = (estimatedTokens * 0.3 * 15) / 1_000_000;
+        return inputCost + outputCost;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pga-ai/adapters-llm-perplexity",
+  "version": "0.8.0",
+  "description": "Perplexity adapter for GSEP — web-search powered responses",
+  "author": "Luis Alfredo Velasquez Duran <contact@gsepcore.com>",
+  "license": "MIT",
+  "homepage": "https://gsepcore.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LuisvelMarketer/pga-platform",
+    "directory": "packages/adapters-llm/perplexity"
+  },
+  "bugs": {
+    "url": "https://github.com/LuisvelMarketer/pga-platform/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "openai": "^4.77.3",
+    "@pga-ai/core": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}