pplx-zero 2.4.0 → 2.4.2

package/README.md

@@ -11,7 +11,8 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/pplx-zero"><img src="https://img.shields.io/npm/v/pplx-zero.svg?color=00d4ff" alt="npm"></a>
   <a href="https://aur.archlinux.org/packages/pplx-zero"><img src="https://img.shields.io/aur/version/pplx-zero?color=00d4ff" alt="AUR"></a>
-  <img src="https://img.shields.io/badge/bun-runtime-f9f1e1" alt="Bun">
+  <img src="https://img.shields.io/npm/dw/pplx-zero?color=00d4ff&label=downloads" alt="npm downloads">
+  <img src="https://img.shields.io/badge/bun-runtime-fbf0df?logo=bun" alt="Bun">
   <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
 </p>
 
@@ -45,7 +46,7 @@ yay -S pplx-zero            # arch linux
 ## Setup
 
 ```bash
-export PERPLEXITY_API_KEY="pplx-..."
+export PERPLEXITY_API_KEY="pplx-..."   # or PERPLEXITY_AI_API_KEY
 ```
 
 Get your key at [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api)

package/bin/pplx.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 import { spawn, execSync } from 'child_process';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pplx-zero",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "Fast, minimal Perplexity AI CLI with local RAG. Stream answers, search your notes, analyze files. Zero bloat.",
   "author": "kenzo",
   "license": "MIT",
@@ -15,10 +15,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "zod": "^4.0.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "^1.3.8"
   },
   "peerDependencies": {
     "typescript": "^5"

package/src/files.ts

@@ -26,11 +26,11 @@ export async function encodeFile(path: string): Promise<FileAttachment> {
   if (path.includes('..')) {
     throw new Error('Path traversal not allowed');
   }
-  
+
   const resolved = resolve(path);
   const ext = extname(resolved).toLowerCase();
   const mimeType = MIME_TYPES[ext];
-  
+
   if (!mimeType) {
     throw new Error(`Unsupported file type: ${ext}`);
   }

package/src/history.ts

@@ -62,10 +62,10 @@ export async function appendHistory(entry: Omit<HistoryEntry, 'ts'>): Promise<vo
 export async function readHistory(limit = 20): Promise<HistoryEntry[]> {
   const file = Bun.file(HISTORY_PATH);
   if (!(await file.exists())) return [];
-  
+
   const text = await file.text();
   const lines = text.trim().split('\n').filter(l => l.length > 0);
-  
+
   return lines
     .map(line => {
       try {

package/src/index.ts

@@ -76,7 +76,7 @@ if (values.history) {
 
 if (values.ingest) {
   const target = positionals[0];
-  
+
   try {
     if (target) {
       const stats = await ingestPath(target);
@@ -90,7 +90,7 @@ if (values.ingest) {
       const stats = await ingestDirectory();
       console.log(`Done! Added: ${stats.added}, Updated: ${stats.updated}, Skipped: ${stats.skipped}`);
     }
-    
+
     console.log(`Total documents: ${getDocCount()}`);
   } catch (err) {
     console.error(fmt.error(err instanceof Error ? err.message : 'Ingest failed'));
@@ -107,16 +107,16 @@ if (values.local) {
     console.error(fmt.error('No query provided for local search.'));
     process.exit(2);
   }
-  
+
   const results = searchForRag(query);
-  
+
   if (results.length === 0) {
     console.log('No local documents match. Proceeding with Perplexity only...\n');
   } else {
     if (!values.json) {
       console.log(`${fmt.model('local')} Found ${results.length} relevant doc(s), using as context...\n`);
     }
-    
+
     ragContext = 'Context from user\'s knowledge base:\n---\n';
     for (const r of results) {
       ragContext += `[${r.title}]:\n${r.content}\n\n`;
@@ -146,7 +146,9 @@ if (ragContext) {
 if (values.continue) {
   const last = await getLastEntry();
   if (last) {
-    const context = `Previous question: "${last.q}"\nPrevious answer: "${last.a.slice(0, 500)}..."\n\nFollow-up question: ${query || 'Continue and elaborate on the previous answer.'}`;
+    const userQuery = positionals.join(' ') || 'Continue and elaborate on the previous answer.';
+    const historyContext = `Previous question: "${last.q}"\nPrevious answer: "${last.a.slice(0, 500)}..."\n\nFollow-up question: ${userQuery}`;
+    const context = ragContext ? ragContext + historyContext : historyContext;
     query = context;
     if (!values.json) {
       await write(fmt.continuing(last.q));
@@ -221,7 +223,7 @@ await search(query, model, {
     if (values.output) {
       const ext = values.output.split('.').pop()?.toLowerCase();
       let content = '';
-      
+
       if (ext === 'md') {
         content = `# ${positionals.join(' ') || 'Query'}\n\n`;
         content += `**Model:** ${model}\n`;
@@ -242,7 +244,7 @@ await search(query, model, {
           });
         }
       }
-      
+
       await Bun.write(values.output, content);
       if (!values.json) {
         await writeLn(`\n${fmt.model('saved')} ${values.output}`);

package/src/output.ts

@@ -14,12 +14,12 @@ export const fmt = {
   searching: () => `${c.dim}Searching...${c.reset}\n`,
   error: (msg: string) => `${c.red}Error: ${msg}${c.reset}\n`,
   citation: (i: number, url: string) => `${c.dim}  ${i}. ${url}${c.reset}`,
-  stats: (tokens: number, ms: number) => 
+  stats: (tokens: number, ms: number) =>
     `\n${c.gray}[${tokens} tokens, ${(ms / 1000).toFixed(1)}s]${c.reset}\n`,
   sources: () => `\n${c.yellow}Sources:${c.reset}`,
   historyEntry: (ts: number, model: string, query: string) => {
-    const date = new Date(ts).toLocaleString('en-US', { 
-      month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' 
+    const date = new Date(ts).toLocaleString('en-US', {
+      month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit'
     });
     return `${c.dim}${date}${c.reset} ${c.cyan}[${model}]${c.reset} ${query}`;
   },

package/src/rag.ts

@@ -12,9 +12,9 @@ let db: Database | null = null;
 
 function getDb(): Database {
   if (db) return db;
-  
+
   db = new Database(DB_PATH);
-  
+
   db.exec(`
     CREATE VIRTUAL TABLE IF NOT EXISTS docs_fts USING fts5(
       path,
@@ -23,7 +23,7 @@ function getDb(): Database {
       tokenize = 'porter unicode61'
     );
   `);
-  
+
   db.exec(`
     CREATE TABLE IF NOT EXISTS docs (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -32,7 +32,7 @@ function getDb(): Database {
       ingested_at INTEGER DEFAULT (unixepoch())
     );
   `);
-  
+
   return db;
 }
 
@@ -56,61 +56,61 @@ export async function ensureKnowledgeDir(): Promise<void> {
 export async function ingestFile(filePath: string): Promise<'added' | 'updated' | 'skipped'> {
   const db = getDb();
   const content = await Bun.file(filePath).text();
-  
+
   if (!content.trim()) return 'skipped';
-  
+
   const title = filePath.split('/').pop()?.replace(/\.(md|txt)$/, '') || filePath;
-  
+
   const existing = db.query('SELECT id FROM docs WHERE path = ?').get(filePath) as { id: number } | null;
-  
+
   if (existing) {
     db.run('DELETE FROM docs_fts WHERE rowid = ?', [existing.id]);
     db.run('UPDATE docs SET title = ?, ingested_at = unixepoch() WHERE id = ?', [title, existing.id]);
-    db.run('INSERT INTO docs_fts (rowid, path, title, content) VALUES (?, ?, ?, ?)', 
+    db.run('INSERT INTO docs_fts (rowid, path, title, content) VALUES (?, ?, ?, ?)',
       [existing.id, filePath, title, content]);
     return 'updated';
   }
-  
+
   const result = db.run('INSERT INTO docs (path, title) VALUES (?, ?)', [filePath, title]);
   const docId = result.lastInsertRowid;
-  db.run('INSERT INTO docs_fts (rowid, path, title, content) VALUES (?, ?, ?, ?)', 
+  db.run('INSERT INTO docs_fts (rowid, path, title, content) VALUES (?, ?, ?, ?)',
     [docId, filePath, title, content]);
-  
+
   return 'added';
 }
 
 export async function ingestDirectory(dir?: string): Promise<IngestStats> {
   await ensureKnowledgeDir();
-  
+
   const targetDir = dir || KNOWLEDGE_DIR;
   const glob = new Glob('**/*.{md,txt}');
   const files: string[] = [];
-  
+
   for await (const file of glob.scan({ cwd: targetDir, absolute: true })) {
     files.push(file);
   }
-  
+
   const stats: IngestStats = { added: 0, updated: 0, skipped: 0 };
-  
+
   for (const file of files) {
     const result = await ingestFile(file);
     stats[result]++;
   }
-  
+
   return stats;
 }
 
 export function search(query: string, limit = 5): SearchResult[] {
   const db = getDb();
-  
+
   const ftsQuery = query
     .trim()
     .split(/\s+/)
     .map(word => `${word}*`)
     .join(' OR ');
-  
+
   const stmt = db.prepare(`
-    SELECT 
+    SELECT
       path,
       title,
       snippet(docs_fts, 2, '>', '<', '...', 40) as snippet,
@@ -120,7 +120,7 @@ export function search(query: string, limit = 5): SearchResult[] {
     ORDER BY score
     LIMIT ?
   `);
-  
+
   try {
     return stmt.all(ftsQuery, limit) as SearchResult[];
   } catch {
@@ -145,13 +145,13 @@ function truncateUtf8Safe(str: string, maxLen: number): string {
 
 export function searchForRag(query: string, limit = 3, maxChars = 4000): RagContext[] {
   const db = getDb();
-  
+
   const ftsQuery = query
     .trim()
     .split(/\s+/)
     .map(word => `${word}*`)
     .join(' OR ');
-  
+
   const stmt = db.prepare(`
     SELECT title, content
     FROM docs_fts
@@ -159,16 +159,16 @@ export function searchForRag(query: string, limit = 3, maxChars = 4000): RagCont
     ORDER BY bm25(docs_fts)
     LIMIT ?
   `);
-  
+
   try {
     const results = stmt.all(ftsQuery, limit) as { title: string; content: string }[];
     let totalChars = 0;
     const truncated: RagContext[] = [];
-    
+
     for (const r of results) {
       const remaining = maxChars - totalChars;
       if (remaining <= 0) break;
-      
+
       const content = truncateUtf8Safe(r.content, remaining);
       truncated.push({
         title: r.title,
@@ -176,7 +176,7 @@ export function searchForRag(query: string, limit = 3, maxChars = 4000): RagCont
       });
       totalChars += content.length;
     }
-    
+
     return truncated;
   } catch {
     return [];
@@ -213,9 +213,9 @@ export async function ingestPath(target: string): Promise<IngestStats> {
   await ensureKnowledgeDir();
   const stats: IngestStats = { added: 0, updated: 0, skipped: 0 };
   const resolved = resolve(target);
-  
+
   const isGlob = target.includes('*');
-  
+
   if (isGlob) {
     const glob = new Glob(target);
     for await (const file of glob.scan({ cwd: process.cwd(), absolute: true })) {
@@ -232,14 +232,14 @@ export async function ingestPath(target: string): Promise<IngestStats> {
     }
     return stats;
   }
-  
+
   let info;
   try {
     info = await stat(resolved);
   } catch {
     throw new Error(`Path not found: ${target}`);
   }
-  
+
   if (info.isDirectory()) {
     console.log(`Indexing directory: ${resolved}`);
     const glob = new Glob('**/*.{md,txt}');
@@ -251,7 +251,7 @@ export async function ingestPath(target: string): Promise<IngestStats> {
     }
     return stats;
   }
-  
+
   const ext = extname(resolved).toLowerCase();
   if (ext === '.pdf') {
     throw new Error('PDF indexing not supported (requires text extraction library). Use -f to send PDFs to Perplexity API instead.');
@@ -259,11 +259,11 @@ export async function ingestPath(target: string): Promise<IngestStats> {
   if (!SUPPORTED_EXTS.has(ext)) {
     throw new Error(`Unsupported file type: ${ext}. Supported: .md, .txt`);
   }
-  
+
   const dest = await copyToKnowledge(resolved);
   const result = await ingestFile(dest);
   stats[result]++;
   console.log(`${result}: ${basename(resolved)} → ~/.pplx/knowledge/`);
-  
+
   return stats;
 }