@oh-my-pi/pi-coding-agent 15.5.6 → 15.5.7

package/src/tools/search.ts

@@ -478,8 +478,8 @@ export class SearchTool implements AgentTool<typeof searchSchema, SearchToolDeta
 						);
 					}
 				} catch (err) {
-					if (err instanceof Error && err.message.startsWith("regex parse error")) {
-						throw new ToolError(err.message);
+					if (err instanceof Error && /^regex(?: parse)? error/i.test(err.message)) {
+						throw new ToolError(err.message.replace(/^regex(?: parse)? error:?\s*/i, "Invalid regex: "));
 					}
 					throw err;
 				}

package/src/tools/tts.ts

@@ -0,0 +1,133 @@
+// Ported from NousResearch/hermes-agent (MIT) — tools/tts_tool.py L167-171, L896-959.
+
+import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
+import * as z from "zod/v4";
+import type { CustomTool, CustomToolContext } from "../extensibility/custom-tools/types";
+import { ohMyPiXAIUserAgent, resolveXAIHttpCredentials } from "../lib/xai-http";
+import { formatPathRelativeToCwd, resolveToCwd } from "./path-utils";
+
+// Hermes tts_tool.py L167-171
+const DEFAULT_XAI_VOICE_ID = "eve" as const;
+const DEFAULT_XAI_LANGUAGE = "en" as const;
+const DEFAULT_XAI_SAMPLE_RATE = 24_000;
+const DEFAULT_XAI_BIT_RATE = 128_000;
+const XAI_MAX_TEXT_LENGTH = 15_000;
+
+// Built-in voices per xAI Tier-1 docs (2026-05-16). xAI also accepts custom voice IDs,
+// so the schema does NOT enum-restrict voice_id; this constant only drives the description.
+const XAI_BUILTIN_VOICES = ["ara", "eve", "leo", "rex", "sal"] as const;
+
+const formatVoiceList = (): string =>
+	XAI_BUILTIN_VOICES.map(v => (v === DEFAULT_XAI_VOICE_ID ? `${v} (default)` : v)).join(", ");
+
+type TtsCodec = "mp3" | "wav";
+
+const ttsSchema = z.object({
+	text: z.string().min(1).max(XAI_MAX_TEXT_LENGTH),
+	voice_id: z.string().default(DEFAULT_XAI_VOICE_ID),
+	language: z.string().default(DEFAULT_XAI_LANGUAGE),
+	output_path: z.string(),
+	sample_rate: z.number().int().optional(),
+	bit_rate: z.number().int().optional(),
+});
+
+interface TtsToolDetails {
+	bytes: number;
+	voiceId: string;
+	codec: TtsCodec;
+}
+
+export const ttsTool: CustomTool<typeof ttsSchema, TtsToolDetails> = {
+	name: "tts",
+	label: "TextToSpeech",
+	strict: false,
+	approval: "write",
+	description:
+		`Synthesize speech from text using xAI Grok Voice. Built-in voices: ${formatVoiceList()}. ` +
+		"Custom voice IDs also accepted. Output codec inferred from output_path suffix (.wav → wav, else mp3). " +
+		`Max ${XAI_MAX_TEXT_LENGTH.toLocaleString("en-US")} characters.`,
+	parameters: ttsSchema,
+	async execute(
+		_toolCallId: string,
+		params: z.infer<typeof ttsSchema>,
+		_onUpdate,
+		ctx: CustomToolContext,
+		signal?: AbortSignal,
+	): Promise<AgentToolResult<TtsToolDetails, typeof ttsSchema>> {
+		const creds = await resolveXAIHttpCredentials(ctx.modelRegistry);
+		if (!creds) {
+			return {
+				isError: true,
+				content: [
+					{
+						type: "text",
+						text: "No xAI credentials. Run /login → xAI Grok OAuth (SuperGrok Subscription) or set XAI_API_KEY.",
+					},
+				],
+			};
+		}
+
+		const cwd = ctx.sessionManager.getCwd();
+		const outputPath = resolveToCwd(params.output_path, cwd);
+		const displayPath = formatPathRelativeToCwd(outputPath, cwd);
+		const codec: TtsCodec = outputPath.toLowerCase().endsWith(".wav") ? "wav" : "mp3";
+		const voiceId = params.voice_id;
+		const language = params.language;
+		const sampleRate = params.sample_rate ?? DEFAULT_XAI_SAMPLE_RATE;
+		const bitRate = params.bit_rate ?? DEFAULT_XAI_BIT_RATE;
+
+		const payload: Record<string, unknown> = {
+			text: params.text,
+			voice_id: voiceId,
+			language,
+		};
+		// Hermes tts_tool.py L926-940 — only send output_format when caller overrides a default.
+		const codecOverridden = codec !== "mp3";
+		const sampleRateOverridden = sampleRate !== DEFAULT_XAI_SAMPLE_RATE;
+		const bitRateOverridden = codec === "mp3" && bitRate !== DEFAULT_XAI_BIT_RATE;
+		if (codecOverridden || sampleRateOverridden || bitRateOverridden) {
+			const fmt: Record<string, unknown> = { codec };
+			if (sampleRate) fmt.sample_rate = sampleRate;
+			if (codec === "mp3" && bitRate) fmt.bit_rate = bitRate;
+			payload.output_format = fmt;
+		}
+
+		// Compose the caller signal with a 60 s timeout fence.
+		const timeoutSignal = AbortSignal.timeout(60_000);
+		const combinedSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+
+		const response = await fetch(`${creds.baseURL}/tts`, {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${creds.apiKey}`,
+				"Content-Type": "application/json",
+				"User-Agent": ohMyPiXAIUserAgent(),
+			},
+			body: JSON.stringify(payload),
+			signal: combinedSignal,
+		});
+		if (!response.ok) {
+			const detail = await response.text();
+			return {
+				isError: true,
+				content: [
+					{
+						type: "text",
+						text: `xAI TTS failed (${response.status}): ${detail.slice(0, 300)}`,
+					},
+				],
+			};
+		}
+		const bytes = new Uint8Array(await response.arrayBuffer());
+		await Bun.write(outputPath, bytes);
+		return {
+			content: [
+				{
+					type: "text",
+					text: `Saved ${bytes.length} bytes to ${displayPath} (voice=${voiceId}, codec=${codec}).`,
+				},
+			],
+			details: { bytes: bytes.length, voiceId, codec },
+		};
+	},
+};