whspr 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -1,2 +1,17 @@
 #!/usr/bin/env node
-export {};
+export declare const DEFAULTS: {
+    transcriptionModel: "whisper-large-v3-turbo";
+    language: string;
+    systemPrompt: string;
+    customPromptPrefix: string;
+    transcriptionPrefix: string;
+};
+export interface WhsprSettings {
+    verbose?: boolean;
+    suffix?: string;
+    transcriptionModel?: "whisper-large-v3" | "whisper-large-v3-turbo";
+    language?: string;
+    systemPrompt?: string;
+    customPromptPrefix?: string;
+    transcriptionPrefix?: string;
+}

package/dist/index.js

@@ -7,7 +7,69 @@ import chalk from "chalk";
 import fs from "fs";
 import path from "path";
 import os from "os";
-const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+// Default prompts (can be overridden in settings.json)
+export const DEFAULTS = {
+    transcriptionModel: "whisper-large-v3-turbo",
+    language: "en",
+    systemPrompt: 'Your task is to clean up/fix transcribed text generated from mic input by the user according to the user\'s own prompt, this prompt may contain custom vocabulary, instructions, etc. Please return the user\'s transcription with the fixes made (e.g. the AI might hear "PostgreSQL" as "post crest QL" you need to use your own reasoning to fix these mistakes in the transcription)',
+    customPromptPrefix: "Here's my custom user prompt:",
+    transcriptionPrefix: "Here's my raw transcription output that I need you to edit:",
+};
+const WHSPR_DIR = path.join(os.homedir(), ".whspr");
+const SETTINGS_PATH = path.join(WHSPR_DIR, "settings.json");
+function loadSettings() {
+    try {
+        if (fs.existsSync(SETTINGS_PATH)) {
+            const content = fs.readFileSync(SETTINGS_PATH, "utf-8");
+            return JSON.parse(content);
+        }
+    }
+    catch (error) {
+        // Silently ignore invalid settings file
+    }
+    return {};
+}
+function loadCustomPrompt(verbose) {
+    const sources = [];
+    let globalPrompt = null;
+    let localPrompt = null;
+    // Check for global WHSPR.md or WHISPER.md in ~/.whspr/
+    const globalWhsprPath = path.join(WHSPR_DIR, "WHSPR.md");
+    const globalWhisperPath = path.join(WHSPR_DIR, "WHISPER.md");
+    if (fs.existsSync(globalWhsprPath)) {
+        globalPrompt = fs.readFileSync(globalWhsprPath, "utf-8");
+        sources.push("~/.whspr/WHSPR.md");
+    }
+    else if (fs.existsSync(globalWhisperPath)) {
+        globalPrompt = fs.readFileSync(globalWhisperPath, "utf-8");
+        sources.push("~/.whspr/WHISPER.md");
+    }
+    // Check for local WHSPR.md or WHISPER.md in current directory
+    const localWhsprPath = path.join(process.cwd(), "WHSPR.md");
+    const localWhisperPath = path.join(process.cwd(), "WHISPER.md");
+    if (fs.existsSync(localWhsprPath)) {
+        localPrompt = fs.readFileSync(localWhsprPath, "utf-8");
+        sources.push("./WHSPR.md");
+    }
+    else if (fs.existsSync(localWhisperPath)) {
+        localPrompt = fs.readFileSync(localWhisperPath, "utf-8");
+        sources.push("./WHISPER.md");
+    }
+    // Combine prompts: global first, then local
+    let combinedPrompt = null;
+    if (globalPrompt && localPrompt) {
+        combinedPrompt = globalPrompt + "\n\n" + localPrompt;
+    }
+    else if (globalPrompt) {
+        combinedPrompt = globalPrompt;
+    }
+    else if (localPrompt) {
+        combinedPrompt = localPrompt;
+    }
+    return { prompt: combinedPrompt, sources };
+}
+const settings = loadSettings();
+const verbose = settings.verbose || process.argv.includes("--verbose") || process.argv.includes("-v");
 function status(message) {
     process.stdout.write(`\x1b[2K\r${chalk.blue(message)}`);
 }
@@ -40,31 +102,28 @@ async function main() {
         try {
             // 3. Transcribe with Whisper
             status("Transcribing...");
-            const rawText = await transcribe(mp3Path);
+            const rawText = await transcribe(mp3Path, settings.transcriptionModel ?? DEFAULTS.transcriptionModel, settings.language ?? DEFAULTS.language);
             if (verbose) {
                 clearStatus();
                 console.log(chalk.gray(`Raw: ${rawText}`));
             }
-            // 4. Read WHSPR.md or WHISPER.md if exists
-            const whsprMdPath = path.join(process.cwd(), "WHSPR.md");
-            const whisperMdPath = path.join(process.cwd(), "WHISPER.md");
-            let customPrompt = null;
-            let vocabFile = null;
-            if (fs.existsSync(whsprMdPath)) {
-                customPrompt = fs.readFileSync(whsprMdPath, "utf-8");
-                vocabFile = "WHSPR.md";
-            }
-            else if (fs.existsSync(whisperMdPath)) {
-                customPrompt = fs.readFileSync(whisperMdPath, "utf-8");
-                vocabFile = "WHISPER.md";
-            }
+            // 4. Read WHSPR.md or WHISPER.md (global from ~/.whspr/ and/or local)
+            const { prompt: customPrompt, sources: vocabSources } = loadCustomPrompt(verbose);
             if (customPrompt && verbose) {
-                console.log(chalk.gray(`Using custom vocabulary from ${vocabFile}`));
+                console.log(chalk.gray(`Using custom vocabulary from: ${vocabSources.join(" + ")}`));
             }
             // 5. Post-process
             status("Post-processing...");
-            const fixedText = await postprocess(rawText, customPrompt);
-            // 6. Output and copy
+            let fixedText = await postprocess(rawText, customPrompt, {
+                systemPrompt: settings.systemPrompt ?? DEFAULTS.systemPrompt,
+                customPromptPrefix: settings.customPromptPrefix ?? DEFAULTS.customPromptPrefix,
+                transcriptionPrefix: settings.transcriptionPrefix ?? DEFAULTS.transcriptionPrefix,
+            });
+            // 6. Apply suffix if configured
+            if (settings.suffix) {
+                fixedText = fixedText + settings.suffix;
+            }
+            // 7. Output and copy
             clearStatus();
             const processTime = ((Date.now() - processStart) / 1000).toFixed(1);
             const wordCount = fixedText.trim().split(/\s+/).filter(w => w.length > 0).length;
@@ -95,7 +154,7 @@ async function main() {
             console.log(chalk.dim("└" + bottomLine) + chalk.dim(stats) + chalk.dim("┘"));
             await copyToClipboard(fixedText);
             console.log(chalk.green("✓") + chalk.gray(" Copied to clipboard"));
-            // 7. Clean up
+            // 8. Clean up
             fs.unlinkSync(mp3Path);
         }
         catch (error) {

package/dist/postprocess.d.ts

@@ -1 +1,6 @@
-export declare function postprocess(rawTranscription: string, customPrompt: string | null): Promise<string>;
+export interface PostprocessOptions {
+    systemPrompt: string;
+    customPromptPrefix: string;
+    transcriptionPrefix: string;
+}
+export declare function postprocess(rawTranscription: string, customPrompt: string | null, options: PostprocessOptions): Promise<string>;

package/dist/postprocess.js

@@ -6,7 +6,8 @@ const MODEL = "openai/gpt-oss-120b";
 const outputSchema = z.object({
     fixed_transcription: z.string(),
 });
-export async function postprocess(rawTranscription, customPrompt) {
+export async function postprocess(rawTranscription, customPrompt, options) {
+    const { systemPrompt, customPromptPrefix, transcriptionPrefix } = options;
     const result = await withRetry(async () => {
         const response = await generateObject({
             model: groq(MODEL),
@@ -14,14 +15,20 @@ export async function postprocess(rawTranscription, customPrompt) {
             messages: [
                 {
                     role: "system",
-                    content: "Your task is to clean up/fix transcribed text generated from mic input by the user according to the user's own prompt, this prompt may contain custom vocabulary, instructions, etc. Please return the user's transcription with the fixes made (e.g. the AI might hear \"PostgreSQL\" as \"post crest QL\" you need to use your own reasoning to fix these mistakes in the transcription)"
+                    content: systemPrompt,
                 },
                 {
                     role: "user",
-                    content: customPrompt
-                        ? `Here's my custom user prompt:\n\`\`\`\n${customPrompt}\n\`\`\`\n\nHere's my raw transcription output that I need you to edit:\n\`\`\`\n${rawTranscription}\n\`\`\``
-                        : `Here's my raw transcription output that I need you to edit:\n\`\`\`\n${rawTranscription}\n\`\`\``
-                }
+                    content: [
+                        customPrompt
+                            ? `${customPromptPrefix}\n\`\`\`\n${customPrompt}\n\`\`\`\n\n`
+                            : null,
+                        `${transcriptionPrefix}\n\`\`\`\n${rawTranscription}\n\`\`\``,
+                    ]
+                        .filter(Boolean)
+                        .join("")
+                        .trim(),
+                },
             ],
         });
         return response.object;

package/dist/transcribe.d.ts

@@ -1 +1,2 @@
-export declare function transcribe(audioPath: string): Promise<string>;
+export type TranscriptionModel = "whisper-large-v3" | "whisper-large-v3-turbo";
+export declare function transcribe(audioPath: string, model?: TranscriptionModel, language?: string): Promise<string>;

package/dist/transcribe.js

@@ -1,12 +1,12 @@
 import Groq from "groq-sdk";
 import fs from "fs";
 const groq = new Groq(); // Uses GROQ_API_KEY env var
-export async function transcribe(audioPath) {
+export async function transcribe(audioPath, model = "whisper-large-v3-turbo", language = "en") {
     const transcription = await groq.audio.transcriptions.create({
         file: fs.createReadStream(audioPath),
-        model: "whisper-large-v3-turbo",
+        model,
         temperature: 0,
-        language: "en",
+        language,
     });
     return transcription.text;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whspr",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "CLI tool for audio transcription with Groq Whisper API",
   "type": "module",
   "bin": {