askpplx 1.4.0 → 1.4.2

package/README.md

@@ -42,23 +42,11 @@ askpplx "Latest TypeScript release notes" --json | jq -r '.sources[].url' | sort
 
 ## Agent Rule
 
-Add this rule to your `CLAUDE.md` or `AGENTS.md` to enable automatic Perplexity lookups, no need to configure MCPs:
+Add this rule to your `CLAUDE.md` or `AGENTS.md`:
 
 ```markdown
-# Rule: `askpplx` CLI Usage
+# Rule: Use `askpplx` for Current Facts
 
-**MANDATORY:** Run `npx -y askpplx --help` at the start of every agent session to learn available options and confirm the tool is working.
-
-Use `askpplx` to query Perplexity, an AI search engine combining real-time web search with advanced language models.
-
-## Why This Matters
-
-- **Ground your knowledge:** Your training data has a cutoff date. Real-time search ensures you work with current information—correct API signatures, latest versions, up-to-date best practices.
-- **Save time and resources:** A quick lookup is far cheaper than debugging hallucinated code or explaining why an approach failed. When in doubt, verify first.
-- **Reduce false confidence:** Even when you feel certain, external verification catches subtle errors before they compound into larger problems.
-- **Stay current:** Libraries change, APIs deprecate, patterns evolve. What was correct six months ago may be wrong today.
-
-## Usage Guidelines
-
-Use concise prompts for quick facts and focused questions for deeper topics. If results are unexpected, refine your query and ask again. Verification is fast and cheap—prefer looking up information over making assumptions.
+At the start of each session, run `npx -y askpplx --help` to verify the CLI is available and configured properly and check available options.
+When a task depends on current or uncertain external information, query `askpplx` instead of relying on memory.
 ```

package/dist/cli.js

@@ -2,37 +2,23 @@
 import { Command, Option } from "@commander-js/extra-typings";
 import packageJson from "../package.json" with { type: "json" };
 import { clearPerplexityApiKey, getConfigPath, getPerplexityApiKey, maskApiKey, setPerplexityApiKey, } from "./config.js";
+import { formatRequiresHelpText } from "./format-requires-help-text.js";
 import { runCli } from "./run-cli.js";
 import { collectStdinText } from "./collect-stdin-text.js";
 import { resolveCliPrompt } from "./resolve-cli-prompt.js";
 const usageExamples = `
-About Perplexity:
-  Perplexity AI is an AI-powered search engine and answer engine that delivers
-  concise, accurate responses to user queries by combining real-time web
-  searches with advanced language models.
-
-Models:
-  sonar               Fast, lightweight for quick searches (128K context)
-  sonar-pro           Advanced multi-step research queries
-  sonar-reasoning-pro Deep reasoning with R1-1776 backend (default)
+Examples:
+  # Quick factual lookup in plain text
+  askpplx "Node.js LTS version"
 
-JSON output (--json):
-  Returns { text, sources[], usage, providerMetadata } - not structured AI output.
-  Use jq to extract fields: --json | jq -r '.text' or '.sources[].url'
+  # Summarize local text from stdin (filter style)
+  cat article.txt | askpplx -S "Summarize this article"
 
-System prompt:
-  Default prompt is optimized for technical/coding questions.
-  Use -s <file> or -S <text> to customize. Use -S "" to disable.
+  # Extract citation URLs for source auditing
+  askpplx "Latest TypeScript release notes" --json | jq -r '.sources[].url' | sort -u
 
-Examples:
-  askpplx "What is the capital of France?" -S ""
-  askpplx "Explain quantum computing" --model sonar-pro
-  askpplx "Latest news on AI" -c medium
-  askpplx "$(cat article.txt)" -s ./summarize.md
-  askpplx "$(cat article.txt)" -S "Summarize this article"
-  cat article.txt | askpplx -S "Summarize this article"
-  askpplx "Node.js LTS version" --json | jq -r '.text'
-  askpplx "Show reasoning" --show-thinking`;
+  # Capture only answer text for scripts
+  askpplx "What changed in React 19?" --json | jq -r '.text'`;
 const program = new Command()
     .name(packageJson.name)
     .description(packageJson.description)
@@ -50,6 +36,7 @@ const program = new Command()
     .option("--show-thinking", "Show model thinking/reasoning blocks")
     .option("--no-stream", "Disable streaming output")
     .addOption(new Option("--no-streaming", "Alias for --no-stream").hideHelp())
+    .addHelpText("before", () => `${formatRequiresHelpText(getPerplexityApiKey())}\n`)
     .addHelpText("after", usageExamples)
     .action(async (prompt, options) => {
     try {
@@ -79,6 +66,7 @@ const program = new Command()
     catch (error) {
         const message = error instanceof Error ? error.message : "An unexpected error occurred";
         console.error(`Error: ${message}`);
+        // eslint-disable-next-line require-atomic-updates -- False positive: no race condition in catch block
         process.exitCode = 1;
     }
 });

package/dist/format-requires-help-text.d.ts

@@ -0,0 +1 @@
+export declare function formatRequiresHelpText(apiKey?: string): string;

package/dist/format-requires-help-text.js

@@ -0,0 +1,11 @@
+function getApiKeySuffix(apiKey) {
+    return apiKey.slice(-4);
+}
+export function formatRequiresHelpText(apiKey) {
+    if (!apiKey) {
+        return ("Requires:\n" +
+            "  - PERPLEXITY_API_KEY - MISSING! Set PERPLEXITY_API_KEY=<token> " +
+            "or run: askpplx config --set-api-key <token>");
+    }
+    return `Requires: PERPLEXITY_API_KEY (configured: last4=${getApiKeySuffix(apiKey)})`;
+}

package/dist/load-system-prompt.js

@@ -1,7 +1,6 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const __dirname = import.meta.dirname;
 const DEFAULT_SYSTEM_PROMPT_PATH = path.join(__dirname, "prompts", "default-system.md");
 export async function loadSystemPrompt(customPath) {
     const promptPath = customPath ?? DEFAULT_SYSTEM_PROMPT_PATH;
@@ -12,11 +11,17 @@ export async function loadSystemPrompt(customPath) {
     catch (error) {
         const code = error.code;
         if (code === "ENOENT") {
-            throw new Error(`System prompt file not found: ${promptPath}`);
+            throw new Error(`System prompt file not found: ${promptPath}`, {
+                cause: error,
+            });
         }
         if (code === "EACCES") {
-            throw new Error(`Permission denied reading system prompt: ${promptPath}`);
+            throw new Error(`Permission denied reading system prompt: ${promptPath}`, {
+                cause: error,
+            });
         }
-        throw new Error(`Failed to read system prompt file: ${promptPath}`);
+        throw new Error(`Failed to read system prompt file: ${promptPath}`, {
+            cause: error,
+        });
     }
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "askpplx",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Minimal Unix-style CLI for querying Perplexity Sonar API.",
   "repository": {
     "type": "git",
@@ -36,36 +36,30 @@
     "typecheck": "tsc -b --noEmit"
   },
   "keywords": [],
-  "packageManager": "pnpm@10.24.0",
+  "packageManager": "pnpm@10.30.1",
   "engines": {
     "node": ">=22.14.0"
   },
   "dependencies": {
-    "@ai-sdk/perplexity": "^2.0.21",
+    "@ai-sdk/perplexity": "^3.0.19",
     "@commander-js/extra-typings": "^14.0.0",
-    "ai": "^5.0.108",
-    "commander": "^14.0.2",
-    "conf": "^15.0.2",
-    "zod": "^4.1.13"
+    "ai": "^6.0.97",
+    "commander": "^14.0.3",
+    "conf": "^15.1.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.0",
-    "@eslint/js": "^9.39.1",
     "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^4.0.15",
-    "@vitest/eslint-plugin": "^1.5.1",
-    "eslint": "^9.39.1",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-unicorn": "^62.0.0",
-    "fta-check": "^1.2.0",
+    "@types/node": "^25.3.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^10.0.1",
+    "eslint-config-axkit": "^1.2.1",
+    "fta-check": "^1.5.1",
     "fta-cli": "^3.0.0",
-    "globals": "^16.5.0",
-    "knip": "^5.71.0",
-    "prettier": "3.7.4",
-    "semantic-release": "^25.0.2",
+    "knip": "^5.85.0",
+    "prettier": "3.8.1",
+    "semantic-release": "^25.0.3",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.1",
-    "vitest": "^4.0.15"
+    "vitest": "^4.0.18"
   }
 }