@codexstar/pi-listen 1.0.10 → 1.0.12

package/extensions/voice/install.ts

@@ -18,7 +18,7 @@ export function buildProvisioningPlan(config: VoiceConfig, diagnostics: Environm
 
 	if (config.mode === "api") {
 		if (config.backend === "deepgram" && !diagnostics.hasDeepgramKey) {
-			manualSteps.push("Set DEEPGRAM_API_KEY before using Deepgram API mode");
+			manualSteps.push("Set DEEPGRAM_API_KEY — get a free key at https://dpgr.am/pi-voice ($200 free credits)");
 		}
 	} else {
 		if (!diagnostics.hasPython) {

package/extensions/voice/onboarding.ts

@@ -140,7 +140,7 @@ export async function runVoiceOnboarding(
 ): Promise<OnboardingResult | undefined> {
 	const modeChoice = await ctx.ui.select("How do you want to use speech-to-text?", [
 		"Recommended for me",
-		"Cloud API (fastest setup)",
+		"Cloud API (fastest setup — free $200 credits from Deepgram)",
 		"Local download (offline / private)",
 	]);
 	if (!modeChoice) return undefined;
@@ -168,6 +168,77 @@ export async function runVoiceOnboarding(
 		if (!cloudSelection) return undefined;
 		backend = cloudSelection.backend;
 		model = cloudSelection.model;
+
+		// ─── Deepgram API key setup ──────────────────────────────
+		if (backend === "deepgram" && !diagnostics.hasDeepgramKey) {
+			const keyAction = await ctx.ui.select(
+				"Deepgram API key not found. What would you like to do?",
+				[
+					"Paste API key now",
+					"I'll set it up later (ask pi to help or export DEEPGRAM_API_KEY=...)",
+				],
+			);
+			if (!keyAction) return undefined;
+
+			if (keyAction.startsWith("Paste")) {
+				ctx.ui.notify(
+					[
+						"Get your free Deepgram API key:",
+						"  → https://dpgr.am/pi-voice",
+						"  (Sign up → $200 free credits, no card needed)",
+						"",
+						"Paste your key below:",
+					].join("\n"),
+					"info",
+				);
+				const apiKey = await ctx.ui.input("DEEPGRAM_API_KEY");
+				if (apiKey && apiKey.trim().length > 10) {
+					const trimmedKey = apiKey.trim();
+					// Write to ~/.env.secrets if it exists, else ~/.zshrc
+					const fs = await import("node:fs");
+					const os = await import("node:os");
+					const home = os.homedir();
+					const envSecretsPath = `${home}/.env.secrets`;
+					const zshrcPath = `${home}/.zshrc`;
+					const exportLine = `export DEEPGRAM_API_KEY="${trimmedKey}"`;
+
+					const targetFile = fs.existsSync(envSecretsPath) ? envSecretsPath : zshrcPath;
+					const existing = fs.existsSync(targetFile) ? fs.readFileSync(targetFile, "utf-8") : "";
+
+					if (existing.includes("DEEPGRAM_API_KEY")) {
+						// Replace existing line
+						const updated = existing.replace(/^export DEEPGRAM_API_KEY=.*$/m, exportLine);
+						fs.writeFileSync(targetFile, updated);
+					} else {
+						fs.appendFileSync(targetFile, `\n${exportLine}\n`);
+					}
+
+					// Also set for current process so daemon can use it immediately
+					process.env.DEEPGRAM_API_KEY = trimmedKey;
+					diagnostics.hasDeepgramKey = true;
+
+					ctx.ui.notify(
+						`API key saved to ${targetFile}\nActive in this session. New terminals will pick it up automatically.`,
+						"info",
+					);
+				} else if (apiKey !== undefined && apiKey !== null) {
+					ctx.ui.notify(
+						"Key looks too short — skipped. You can set it later:\n  export DEEPGRAM_API_KEY=\"your-key\"",
+						"warning",
+					);
+				}
+			} else {
+				ctx.ui.notify(
+					[
+						"No problem! When you're ready:",
+						"  1. Get a key → https://dpgr.am/pi-voice ($200 free credits)",
+						"  2. Run: export DEEPGRAM_API_KEY=\"your-key\"",
+						"  3. Or ask pi: \"help me set up my Deepgram API key\"",
+					].join("\n"),
+					"info",
+				);
+			}
+		}
 	} else {
 		const localSelection = await chooseBackendAndModel(
 			ctx,

package/extensions/voice.ts

@@ -351,6 +351,8 @@ export default function (pi: ExtensionAPI) {
 
 	// ─── Voice: Start / Stop / Transcribe ────────────────────────────────────
 
+	const MAX_RECORDING_SECS = 30; // Safety cap: auto-stop after 30s
+
 	async function startVoiceRecording(target: "editor" | "btw" = "editor"): Promise<boolean> {
 		if (voiceState !== "idle" || !ctx) return false;
 
@@ -363,14 +365,22 @@ export default function (pi: ExtensionAPI) {
 		recordingStart = Date.now();
 		setVoiceState("recording");
 		statusTimer = setInterval(() => {
-			if (voiceState === "recording") updateVoiceStatus();
+			if (voiceState === "recording") {
+				updateVoiceStatus();
+				// Safety: auto-stop after MAX_RECORDING_SECS
+				const elapsed = (Date.now() - recordingStart) / 1000;
+				if (elapsed >= MAX_RECORDING_SECS) {
+					isHolding = false;
+					stopVoiceRecording(target);
+				}
+			}
 		}, 1000);
 
 		if (ctx.hasUI) {
 			ctx.ui.setWidget("voice-recording", [
 				target === "btw"
-					? " BTW Recording... release to send"
-					: " Recording... release to transcribe",
+					? " 🎙 BTW Recording... Ctrl+Shift+V to stop"
+					: " 🎙 Recording... Ctrl+Shift+V to stop (or release SPACE)",
 			], { placement: "aboveEditor" });
 		}
 		return true;
@@ -679,6 +689,7 @@ export default function (pi: ExtensionAPI) {
 			if (voiceState === "idle") {
 				await startVoiceRecording("editor");
 			} else if (voiceState === "recording") {
+				isHolding = false;
 				await stopVoiceRecording("editor");
 			}
 		},
@@ -744,7 +755,7 @@ export default function (pi: ExtensionAPI) {
 	// ─── /voice command ──────────────────────────────────────────────────────
 
 	pi.registerCommand("voice", {
-		description: "Voice input: /voice [on|off|test|info|setup|reconfigure|doctor|backends|daemon]",
+		description: "Voice input: /voice [on|off|stop|test|info|setup|reconfigure|doctor|backends|daemon]",
 		handler: async (args, cmdCtx) => {
 			ctx = cmdCtx;
 			const sub = (args || "").trim().toLowerCase();
@@ -754,7 +765,7 @@ export default function (pi: ExtensionAPI) {
 				updateVoiceStatus();
 				setupHoldToTalk();
 				ensureDaemon(config).catch(() => {});
-				cmdCtx.ui.notify("Voice enabled. Hold SPACE (empty editor) to record.", "info");
+				cmdCtx.ui.notify("Voice enabled.\n  Hold SPACE (empty editor) → release to transcribe\n  Ctrl+Shift+V → toggle recording on/off\n  Auto-stops after 30s", "info");
 				return;
 			}
 
@@ -767,6 +778,18 @@ export default function (pi: ExtensionAPI) {
 				return;
 			}
 
+			if (sub === "stop") {
+				// Emergency stop — cancel any active recording
+				if (voiceState === "recording") {
+					isHolding = false;
+					await stopVoiceRecording("editor");
+					cmdCtx.ui.notify("Recording stopped and transcribed.", "info");
+				} else {
+					cmdCtx.ui.notify("No recording in progress.", "info");
+				}
+				return;
+			}
+
 			if (sub === "test") {
 				cmdCtx.ui.notify("Testing voice setup...", "info");
 				const diagnostics = scanEnvironment(TRANSCRIBE_SCRIPT);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexstar/pi-listen",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Voice input, first-run onboarding, and side-channel BTW conversations for Pi",
   "type": "module",
   "keywords": [