@tryhamster/gerbil 1.0.0-rc.1 → 1.0.0-rc.10

package/dist/stt-Dne6SENv.js

@@ -0,0 +1,434 @@
+//#region src/core/stt.ts
+/**
+* Available Whisper models
+* Ordered by size (smallest first)
+*/
+const WHISPER_MODELS = [
+	{
+		id: "whisper-tiny.en",
+		repo: "onnx-community/whisper-tiny.en",
+		description: "Tiny English-only model, fastest",
+		size: "39M",
+		multilingual: false,
+		languages: ["en"],
+		sampleRate: 16e3
+	},
+	{
+		id: "whisper-tiny",
+		repo: "onnx-community/whisper-tiny",
+		description: "Tiny multilingual model",
+		size: "39M",
+		multilingual: true,
+		languages: [
+			"en",
+			"es",
+			"fr",
+			"de",
+			"it",
+			"pt",
+			"nl",
+			"ru",
+			"zh",
+			"ja",
+			"ko"
+		],
+		sampleRate: 16e3
+	},
+	{
+		id: "whisper-base.en",
+		repo: "onnx-community/whisper-base.en",
+		description: "Base English-only model, good balance",
+		size: "74M",
+		multilingual: false,
+		languages: ["en"],
+		sampleRate: 16e3
+	},
+	{
+		id: "whisper-base",
+		repo: "onnx-community/whisper-base",
+		description: "Base multilingual model",
+		size: "74M",
+		multilingual: true,
+		languages: [
+			"en",
+			"es",
+			"fr",
+			"de",
+			"it",
+			"pt",
+			"nl",
+			"ru",
+			"zh",
+			"ja",
+			"ko"
+		],
+		sampleRate: 16e3
+	},
+	{
+		id: "whisper-small.en",
+		repo: "onnx-community/whisper-small.en",
+		description: "Small English-only model, high quality",
+		size: "244M",
+		multilingual: false,
+		languages: ["en"],
+		sampleRate: 16e3
+	},
+	{
+		id: "whisper-small",
+		repo: "onnx-community/whisper-small",
+		description: "Small multilingual model",
+		size: "244M",
+		multilingual: true,
+		languages: [
+			"en",
+			"es",
+			"fr",
+			"de",
+			"it",
+			"pt",
+			"nl",
+			"ru",
+			"zh",
+			"ja",
+			"ko"
+		],
+		sampleRate: 16e3
+	},
+	{
+		id: "whisper-large-v3-turbo",
+		repo: "onnx-community/whisper-large-v3-turbo",
+		description: "Large Turbo model, 5.4x faster, 80+ languages",
+		size: "809M",
+		multilingual: true,
+		languages: [
+			"en",
+			"es",
+			"fr",
+			"de",
+			"it",
+			"pt",
+			"nl",
+			"ru",
+			"zh",
+			"ja",
+			"ko",
+			"ar",
+			"hi",
+			"vi",
+			"th"
+		],
+		sampleRate: 16e3
+	}
+];
+const DEFAULT_MODEL = "whisper-tiny.en";
+/**
+* Decode WAV file to Float32Array
+* Handles stereo to mono conversion
+*/
+function decodeWav(buffer) {
+	const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+	if (String.fromCharCode(buffer[0], buffer[1], buffer[2], buffer[3]) !== "RIFF") throw new Error("Invalid WAV file: missing RIFF header");
+	const numChannels = view.getUint16(22, true);
+	const sampleRate = view.getUint32(24, true);
+	const bitsPerSample = view.getUint16(34, true);
+	if (bitsPerSample !== 16) throw new Error(`Unsupported bit depth: ${bitsPerSample}. Only 16-bit WAV is supported.`);
+	let dataOffset = 12;
+	while (dataOffset < buffer.length - 8) {
+		const chunkId = String.fromCharCode(buffer[dataOffset], buffer[dataOffset + 1], buffer[dataOffset + 2], buffer[dataOffset + 3]);
+		const chunkSize = view.getUint32(dataOffset + 4, true);
+		if (chunkId === "data") {
+			dataOffset += 8;
+			break;
+		}
+		dataOffset += 8 + chunkSize;
+	}
+	const dataSize = buffer.length - dataOffset;
+	const bytesPerSample = bitsPerSample / 8;
+	const totalSamples = Math.floor(dataSize / bytesPerSample);
+	const samplesPerChannel = Math.floor(totalSamples / numChannels);
+	const audio = new Float32Array(samplesPerChannel);
+	for (let i = 0; i < samplesPerChannel; i++) if (numChannels === 2) audio[i] = (view.getInt16(dataOffset + i * 4, true) + view.getInt16(dataOffset + i * 4 + 2, true)) / 2 / 32768;
+	else audio[i] = view.getInt16(dataOffset + i * 2, true) / 32768;
+	return {
+		audio,
+		sampleRate
+	};
+}
+/**
+* Resample audio to target sample rate using linear interpolation
+*/
+function resampleAudio(audio, fromRate, toRate) {
+	if (fromRate === toRate) return audio;
+	const ratio = toRate / fromRate;
+	const newLength = Math.round(audio.length * ratio);
+	const result = new Float32Array(newLength);
+	for (let i = 0; i < newLength; i++) {
+		const srcIndex = i / ratio;
+		const floor = Math.floor(srcIndex);
+		const ceil = Math.min(floor + 1, audio.length - 1);
+		const t = srcIndex - floor;
+		result[i] = audio[floor] * (1 - t) + audio[ceil] * t;
+	}
+	return result;
+}
+/**
+* Speech-to-Text using Whisper ONNX models
+*/
+var WhisperSTT = class {
+	modelConfig;
+	pipeline = null;
+	loadPromise = null;
+	_isLoaded = false;
+	_deviceMode = "cpu";
+	constructor(modelId = DEFAULT_MODEL) {
+		const config = WHISPER_MODELS.find((m) => m.id === modelId);
+		if (!config) {
+			const available = WHISPER_MODELS.map((m) => m.id).join(", ");
+			throw new Error(`Unknown STT model: ${modelId}. Available: ${available}`);
+		}
+		this.modelConfig = config;
+	}
+	/**
+	* Check if model is loaded
+	*/
+	isLoaded() {
+		return this._isLoaded;
+	}
+	/**
+	* Get model configuration
+	*/
+	getModelConfig() {
+		return this.modelConfig;
+	}
+	/**
+	* Get model info (alias for getModelConfig)
+	*/
+	getModelInfo() {
+		return this.modelConfig;
+	}
+	/**
+	* Get current device mode
+	*/
+	getDeviceMode() {
+		return this._deviceMode;
+	}
+	/**
+	* List available models
+	*/
+	static listModels() {
+		return [...WHISPER_MODELS];
+	}
+	/**
+	* Load the STT model
+	*/
+	async load(options = {}) {
+		if (this._isLoaded) return;
+		if (this.loadPromise) {
+			await this.loadPromise;
+			return;
+		}
+		this.loadPromise = this._load(options);
+		await this.loadPromise;
+	}
+	async _load(options = {}) {
+		const { onProgress, device = "auto" } = options;
+		onProgress?.({ status: "Loading transformers.js..." });
+		const isNode = typeof process !== "undefined" && process.versions?.node;
+		const { pipeline, env } = await import("./transformers.web-u34VxRFM.js");
+		if (isNode) {
+			env.allowLocalModels = true;
+			env.allowRemoteModels = true;
+		} else {
+			env.useBrowserCache = true;
+			env.allowLocalModels = false;
+			if (env.backends?.onnx?.wasm) env.backends.onnx.wasm.wasmPaths = "https://cdn.jsdelivr.net/npm/onnxruntime-web@1.21.0/dist/";
+		}
+		let tfDevice = "cpu";
+		if (!isNode) tfDevice = "wasm";
+		this._deviceMode = "cpu";
+		onProgress?.({ status: `Loading ${this.modelConfig.id}...` });
+		this.pipeline = await pipeline("automatic-speech-recognition", this.modelConfig.repo, {
+			dtype: "fp32",
+			device: tfDevice,
+			progress_callback: (progress) => {
+				if (progress.status === "progress" && progress.file) onProgress?.({
+					status: `Downloading ${progress.file}`,
+					progress: Math.round(progress.progress || 0),
+					file: progress.file
+				});
+			}
+		});
+		this._isLoaded = true;
+		onProgress?.({ status: `Ready (${tfDevice.toUpperCase()})!` });
+	}
+	/**
+	* Transcribe audio to text
+	*
+	* @param audio - Audio data as Float32Array (mono, 16kHz preferred) or Uint8Array (WAV file)
+	* @param options - Transcription options
+	* @returns Transcription result with text and optional timestamps
+	*/
+	async transcribe(audio, options = {}) {
+		if (!this._isLoaded) throw new Error("STT model not loaded. Call load() first.");
+		const { language, timestamps = false, onProgress } = options;
+		const startTime = performance.now();
+		let audioData;
+		let inputSampleRate = 16e3;
+		if (audio instanceof Uint8Array) {
+			onProgress?.({ status: "Decoding audio..." });
+			const decoded = decodeWav(audio);
+			audioData = decoded.audio;
+			inputSampleRate = decoded.sampleRate;
+		} else audioData = audio;
+		if (inputSampleRate !== 16e3) {
+			onProgress?.({ status: "Resampling to 16kHz..." });
+			audioData = resampleAudio(audioData, inputSampleRate, 16e3);
+		}
+		const audioDuration = audioData.length / 16e3;
+		onProgress?.({ status: `Transcribing ${audioDuration.toFixed(1)}s of audio...` });
+		const pipelineOptions = {};
+		if (language && this.modelConfig.multilingual) {
+			pipelineOptions.language = language;
+			pipelineOptions.task = "transcribe";
+		}
+		if (timestamps) pipelineOptions.return_timestamps = true;
+		const result = await this.pipeline(audioData, pipelineOptions);
+		const totalTime = performance.now() - startTime;
+		let text = result.text?.trim() || "";
+		if (text === "[BLANK_AUDIO]" || text === "(blank audio)" || text === "[BLANK AUDIO]") text = "";
+		const transcribeResult = {
+			text,
+			language: language || (this.modelConfig.multilingual ? "auto" : "en"),
+			duration: audioDuration,
+			totalTime
+		};
+		if (timestamps && result.chunks) transcribeResult.segments = result.chunks.map((chunk) => ({
+			text: chunk.text?.trim() || "",
+			start: chunk.timestamp?.[0] || 0,
+			end: chunk.timestamp?.[1] || 0
+		}));
+		onProgress?.({ status: "Done!" });
+		return transcribeResult;
+	}
+	/**
+	* Create a streaming transcription session
+	*
+	* Transcribes audio in real-time by processing chunks at regular intervals.
+	* Perfect for live captioning, call transcription, or real-time subtitles.
+	*
+	* @param options - Streaming options
+	* @returns Streaming session controller
+	*
+	* @example
+	* ```ts
+	* const session = stt.createStreamingSession({
+	*   chunkDuration: 3000,  // Transcribe every 3 seconds
+	*   onChunk: (text, idx) => console.log(`Chunk ${idx}: ${text}`),
+	*   onTranscript: (fullText) => console.log("Full:", fullText),
+	* });
+	*
+	* // Feed audio data as it comes in (Float32Array at 16kHz)
+	* session.feedAudio(audioChunk);
+	*
+	* // Or manually trigger transcription
+	* await session.flush();
+	*
+	* // Stop and get final transcript
+	* const finalText = await session.stop();
+	* ```
+	*/
+	createStreamingSession(options = {}) {
+		const { chunkDuration = 3e3, minChunkSize = 8e3, onChunk, onTranscript, onError, language } = options;
+		let audioBuffer = [];
+		let fullTranscript = "";
+		let chunkIndex = 0;
+		let intervalId = null;
+		let isRunning = false;
+		const getBufferSize = () => {
+			return audioBuffer.reduce((sum, chunk) => sum + chunk.length, 0);
+		};
+		const mergeBuffer = () => {
+			const totalLength = getBufferSize();
+			const merged = new Float32Array(totalLength);
+			let offset = 0;
+			for (const chunk of audioBuffer) {
+				merged.set(chunk, offset);
+				offset += chunk.length;
+			}
+			return merged;
+		};
+		const transcribeBuffer = async () => {
+			if (!this._isLoaded || getBufferSize() < minChunkSize) return "";
+			const audio = mergeBuffer();
+			audioBuffer = [];
+			try {
+				const text = (await this.transcribe(audio, { language })).text.trim();
+				if (text) {
+					chunkIndex++;
+					onChunk?.(text, chunkIndex);
+					fullTranscript = fullTranscript + (fullTranscript ? " " : "") + text;
+					onTranscript?.(fullTranscript);
+				}
+				return text;
+			} catch (e) {
+				onError?.(e.message || "Transcription failed");
+				return "";
+			}
+		};
+		let aborted = false;
+		return {
+			feedAudio: (audio) => {
+				if (!aborted) audioBuffer.push(audio);
+			},
+			flush: async () => {
+				if (aborted) return "";
+				return transcribeBuffer();
+			},
+			start: () => {
+				if (isRunning || aborted) return;
+				isRunning = true;
+				intervalId = setInterval(async () => {
+					if (isRunning && !aborted) await transcribeBuffer();
+				}, chunkDuration);
+			},
+			stop: async () => {
+				isRunning = false;
+				if (intervalId) {
+					clearInterval(intervalId);
+					intervalId = null;
+				}
+				if (!aborted && getBufferSize() >= minChunkSize) await transcribeBuffer();
+				return fullTranscript;
+			},
+			abort: () => {
+				aborted = true;
+				isRunning = false;
+				if (intervalId) {
+					clearInterval(intervalId);
+					intervalId = null;
+				}
+				audioBuffer = [];
+			},
+			isRunning: () => isRunning,
+			getTranscript: () => fullTranscript,
+			getChunkCount: () => chunkIndex,
+			reset: () => {
+				audioBuffer = [];
+				fullTranscript = "";
+				chunkIndex = 0;
+			}
+		};
+	}
+	/**
+	* Dispose of resources
+	*/
+	dispose() {
+		this.pipeline = null;
+		this._isLoaded = false;
+		this.loadPromise = null;
+	}
+};
+
+//#endregion
+export { WhisperSTT };
+//# sourceMappingURL=stt-Dne6SENv.js.map

package/dist/stt-Dne6SENv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-Dne6SENv.js","names":["WHISPER_MODELS: STTModelConfig[]","tfDevice: \"webgpu\" | \"cpu\" | \"wasm\"","audioData: Float32Array","pipelineOptions: any","transcribeResult: TranscribeResult","audioBuffer: Float32Array[]","intervalId: ReturnType<typeof setInterval> | null","e: any"],"sources":["../src/core/stt.ts"],"sourcesContent":["/**\n * Speech-to-Text with Whisper\n *\n * Provides local speech recognition using Whisper ONNX models via transformers.js.\n * Supports multiple model sizes and languages.\n *\n * @example\n * ```ts\n * const stt = new WhisperSTT();\n * await stt.load({ onProgress: (p) => console.log(p.status) });\n *\n * // Transcribe audio (Float32Array at 16kHz)\n * const result = await stt.transcribe(audioData);\n * console.log(result.text);\n *\n * // With timestamps\n * const result = await stt.transcribe(audioData, { timestamps: true });\n * for (const seg of result.segments) {\n *   console.log(`[${seg.start.toFixed(1)}s] ${seg.text}`);\n * }\n * ```\n */\n\nimport type {\n  LoadSTTOptions,\n  ProgressInfo,\n  STTModelConfig,\n  StreamingTranscriptionOptions,\n  StreamingTranscriptionSession,\n  TranscribeOptions,\n  TranscribeResult,\n  TranscribeSegment,\n} from \"./types.js\";\n\n// ============================================\n// Model Registry\n// ============================================\n\n/**\n * Available Whisper models\n * Ordered by size (smallest first)\n */\nexport const WHISPER_MODELS: STTModelConfig[] = [\n  {\n    id: \"whisper-tiny.en\",\n    repo: \"onnx-community/whisper-tiny.en\",\n    description: \"Tiny English-only model, fastest\",\n    size: \"39M\",\n    multilingual: false,\n    languages: [\"en\"],\n    sampleRate: 16000,\n  },\n  {\n    id: \"whisper-tiny\",\n    repo: \"onnx-community/whisper-tiny\",\n    description: \"Tiny multilingual model\",\n    size: \"39M\",\n    multilingual: true,\n    languages: [\"en\", \"es\", \"fr\", \"de\", \"it\", \"pt\", \"nl\", \"ru\", \"zh\", \"ja\", \"ko\"],\n    sampleRate: 16000,\n  },\n  {\n    id: \"whisper-base.en\",\n    repo: \"onnx-community/whisper-base.en\",\n    description: \"Base English-only model, good balance\",\n    size: \"74M\",\n    multilingual: false,\n    languages: [\"en\"],\n    sampleRate: 16000,\n  },\n  {\n    id: \"whisper-base\",\n    repo: \"onnx-community/whisper-base\",\n    description: \"Base multilingual model\",\n    size: \"74M\",\n    multilingual: true,\n    languages: [\"en\", \"es\", \"fr\", \"de\", \"it\", \"pt\", \"nl\", \"ru\", \"zh\", \"ja\", \"ko\"],\n    sampleRate: 16000,\n  },\n  {\n    id: \"whisper-small.en\",\n    repo: \"onnx-community/whisper-small.en\",\n    description: \"Small English-only model, high quality\",\n    size: \"244M\",\n    multilingual: false,\n    languages: [\"en\"],\n    sampleRate: 16000,\n  },\n  {\n    id: \"whisper-small\",\n    repo: \"onnx-community/whisper-small\",\n    description: \"Small multilingual model\",\n    size: \"244M\",\n    multilingual: true,\n    languages: [\"en\", \"es\", \"fr\", \"de\", \"it\", \"pt\", \"nl\", \"ru\", \"zh\", \"ja\", \"ko\"],\n    sampleRate: 16000,\n  },\n  {\n    id: \"whisper-large-v3-turbo\",\n    repo: \"onnx-community/whisper-large-v3-turbo\",\n    description: \"Large Turbo model, 5.4x faster, 80+ languages\",\n    size: \"809M\",\n    multilingual: true,\n    languages: [\n      \"en\",\n      \"es\",\n      \"fr\",\n      \"de\",\n      \"it\",\n      \"pt\",\n      \"nl\",\n      \"ru\",\n      \"zh\",\n      \"ja\",\n      \"ko\",\n      \"ar\",\n      \"hi\",\n      \"vi\",\n      \"th\",\n    ],\n    sampleRate: 16000,\n  },\n];\n\n// Default model\nconst DEFAULT_MODEL = \"whisper-tiny.en\";\n\n// ============================================\n// Audio Utilities\n// ============================================\n\n/**\n * Decode WAV file to Float32Array\n * Handles stereo to mono conversion\n */\nexport function decodeWav(buffer: Uint8Array): { audio: Float32Array; sampleRate: number } {\n  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);\n\n  // Validate RIFF header\n  const riff = String.fromCharCode(buffer[0], buffer[1], buffer[2], buffer[3]);\n  if (riff !== \"RIFF\") {\n    throw new Error(\"Invalid WAV file: missing RIFF header\");\n  }\n\n  // Get format details\n  const numChannels = view.getUint16(22, true);\n  const sampleRate = view.getUint32(24, true);\n  const bitsPerSample = view.getUint16(34, true);\n\n  if (bitsPerSample !== 16) {\n    throw new Error(`Unsupported bit depth: ${bitsPerSample}. Only 16-bit WAV is supported.`);\n  }\n\n  // Find data chunk\n  let dataOffset = 12;\n  while (dataOffset < buffer.length - 8) {\n    const chunkId = String.fromCharCode(\n      buffer[dataOffset],\n      buffer[dataOffset + 1],\n      buffer[dataOffset + 2],\n      buffer[dataOffset + 3],\n    );\n    const chunkSize = view.getUint32(dataOffset + 4, true);\n    if (chunkId === \"data\") {\n      dataOffset += 8;\n      break;\n    }\n    dataOffset += 8 + chunkSize;\n  }\n\n  const dataSize = buffer.length - dataOffset;\n  const bytesPerSample = bitsPerSample / 8;\n  const totalSamples = Math.floor(dataSize / bytesPerSample);\n  const samplesPerChannel = Math.floor(totalSamples / numChannels);\n\n  // Convert to mono Float32Array\n  const audio = new Float32Array(samplesPerChannel);\n\n  for (let i = 0; i < samplesPerChannel; i++) {\n    if (numChannels === 2) {\n      const left = view.getInt16(dataOffset + i * 4, true);\n      const right = view.getInt16(dataOffset + i * 4 + 2, true);\n      audio[i] = (left + right) / 2 / 32768;\n    } else {\n      const sample = view.getInt16(dataOffset + i * 2, true);\n      audio[i] = sample / 32768;\n    }\n  }\n\n  return { audio, sampleRate };\n}\n\n/**\n * Resample audio to target sample rate using linear interpolation\n */\nexport function resampleAudio(audio: Float32Array, fromRate: number, toRate: number): Float32Array {\n  if (fromRate === toRate) return audio;\n\n  const ratio = toRate / fromRate;\n  const newLength = Math.round(audio.length * ratio);\n  const result = new Float32Array(newLength);\n\n  for (let i = 0; i < newLength; i++) {\n    const srcIndex = i / ratio;\n    const floor = Math.floor(srcIndex);\n    const ceil = Math.min(floor + 1, audio.length - 1);\n    const t = srcIndex - floor;\n    result[i] = audio[floor] * (1 - t) + audio[ceil] * t;\n  }\n\n  return result;\n}\n\n// ============================================\n// WhisperSTT Class\n// ============================================\n\n/**\n * Speech-to-Text using Whisper ONNX models\n */\nexport class WhisperSTT {\n  private modelConfig: STTModelConfig;\n  private pipeline: any = null;\n  private loadPromise: Promise<void> | null = null;\n  private _isLoaded = false;\n  private _deviceMode: \"webgpu\" | \"cpu\" = \"cpu\";\n\n  constructor(modelId: string = DEFAULT_MODEL) {\n    const config = WHISPER_MODELS.find((m) => m.id === modelId);\n    if (!config) {\n      const available = WHISPER_MODELS.map((m) => m.id).join(\", \");\n      throw new Error(`Unknown STT model: ${modelId}. Available: ${available}`);\n    }\n    this.modelConfig = config;\n  }\n\n  /**\n   * Check if model is loaded\n   */\n  isLoaded(): boolean {\n    return this._isLoaded;\n  }\n\n  /**\n   * Get model configuration\n   */\n  getModelConfig(): STTModelConfig {\n    return this.modelConfig;\n  }\n\n  /**\n   * Get model info (alias for getModelConfig)\n   */\n  getModelInfo(): STTModelConfig {\n    return this.modelConfig;\n  }\n\n  /**\n   * Get current device mode\n   */\n  getDeviceMode(): \"webgpu\" | \"cpu\" {\n    return this._deviceMode;\n  }\n\n  /**\n   * List available models\n   */\n  static listModels(): STTModelConfig[] {\n    return [...WHISPER_MODELS];\n  }\n\n  /**\n   * Load the STT model\n   */\n  async load(options: LoadSTTOptions = {}): Promise<void> {\n    if (this._isLoaded) return;\n    if (this.loadPromise) {\n      await this.loadPromise;\n      return;\n    }\n\n    this.loadPromise = this._load(options);\n    await this.loadPromise;\n  }\n\n  private async _load(options: LoadSTTOptions = {}): Promise<void> {\n    const { onProgress, device = \"auto\" } = options;\n\n    onProgress?.({ status: \"Loading transformers.js...\" });\n\n    // Check if we're in Node.js or browser\n    const isNode = typeof process !== \"undefined\" && process.versions?.node;\n\n    // Import transformers.js dynamically\n    // tsdown handles resolution: Node.js = external, Browser = bundled\n    const { pipeline, env } = await import(\"@huggingface/transformers\");\n\n    // Configure environment based on runtime\n    if (isNode) {\n      // Node.js: allow local models (for CLI/server use)\n      env.allowLocalModels = true;\n      env.allowRemoteModels = true;\n    } else {\n      // Browser: use IndexedDB cache, fetch from HuggingFace CDN\n      env.useBrowserCache = true;\n      env.allowLocalModels = false;\n      // Load WASM files from CDN (not bundled with gerbil)\n      if (env.backends?.onnx?.wasm) {\n        env.backends.onnx.wasm.wasmPaths =\n          \"https://cdn.jsdelivr.net/npm/onnxruntime-web@1.21.0/dist/\";\n      }\n    }\n\n    // Determine device\n    // Note: Whisper ONNX models work best with fp32 on CPU/WASM\n    // WebGPU support for ASR is limited, so we use CPU for reliability\n    let tfDevice: \"webgpu\" | \"cpu\" | \"wasm\" = \"cpu\";\n\n    // In browser, use WASM for better compatibility\n    if (!isNode) {\n      tfDevice = \"wasm\";\n    }\n\n    // Store device mode\n    this._deviceMode = \"cpu\"; // STT always reports as CPU since WASM is CPU-based\n\n    onProgress?.({ status: `Loading ${this.modelConfig.id}...` });\n\n    // Load the ASR pipeline\n    // Always use fp32 for Whisper models (fp16 not available for ONNX ASR)\n    this.pipeline = await pipeline(\"automatic-speech-recognition\", this.modelConfig.repo, {\n      dtype: \"fp32\",\n      device: tfDevice,\n      progress_callback: (progress: any) => {\n        if (progress.status === \"progress\" && progress.file) {\n          onProgress?.({\n            status: `Downloading ${progress.file}`,\n            progress: Math.round(progress.progress || 0),\n            file: progress.file,\n          });\n        }\n      },\n    });\n\n    this._isLoaded = true;\n    onProgress?.({ status: `Ready (${tfDevice.toUpperCase()})!` });\n  }\n\n  /**\n   * Transcribe audio to text\n   *\n   * @param audio - Audio data as Float32Array (mono, 16kHz preferred) or Uint8Array (WAV file)\n   * @param options - Transcription options\n   * @returns Transcription result with text and optional timestamps\n   */\n  async transcribe(\n    audio: Float32Array | Uint8Array,\n    options: TranscribeOptions = {},\n  ): Promise<TranscribeResult> {\n    if (!this._isLoaded) {\n      throw new Error(\"STT model not loaded. Call load() first.\");\n    }\n\n    const { language, timestamps = false, onProgress } = options;\n    const startTime = performance.now();\n\n    // Convert Uint8Array (WAV) to Float32Array\n    let audioData: Float32Array;\n    let inputSampleRate = 16000;\n\n    if (audio instanceof Uint8Array) {\n      onProgress?.({ status: \"Decoding audio...\" });\n      const decoded = decodeWav(audio);\n      audioData = decoded.audio;\n      inputSampleRate = decoded.sampleRate;\n    } else {\n      audioData = audio;\n    }\n\n    // Resample to 16kHz if needed\n    if (inputSampleRate !== 16000) {\n      onProgress?.({ status: \"Resampling to 16kHz...\" });\n      audioData = resampleAudio(audioData, inputSampleRate, 16000);\n    }\n\n    const audioDuration = audioData.length / 16000;\n    onProgress?.({ status: `Transcribing ${audioDuration.toFixed(1)}s of audio...` });\n\n    // Build pipeline options\n    const pipelineOptions: any = {};\n\n    // Only set language for multilingual models\n    if (language && this.modelConfig.multilingual) {\n      pipelineOptions.language = language;\n      pipelineOptions.task = \"transcribe\";\n    }\n\n    // Enable timestamps if requested\n    if (timestamps) {\n      pipelineOptions.return_timestamps = true;\n    }\n\n    // Run transcription\n    const result = await this.pipeline(audioData, pipelineOptions);\n\n    const totalTime = performance.now() - startTime;\n\n    // Build result\n    let text = result.text?.trim() || \"\";\n\n    // Filter out Whisper artifacts\n    if (text === \"[BLANK_AUDIO]\" || text === \"(blank audio)\" || text === \"[BLANK AUDIO]\") {\n      text = \"\";\n    }\n\n    const transcribeResult: TranscribeResult = {\n      text,\n      language: language || (this.modelConfig.multilingual ? \"auto\" : \"en\"),\n      duration: audioDuration,\n      totalTime,\n    };\n\n    // Add segments if timestamps were requested\n    if (timestamps && result.chunks) {\n      transcribeResult.segments = result.chunks.map(\n        (chunk: any): TranscribeSegment => ({\n          text: chunk.text?.trim() || \"\",\n          start: chunk.timestamp?.[0] || 0,\n          end: chunk.timestamp?.[1] || 0,\n        }),\n      );\n    }\n\n    onProgress?.({ status: \"Done!\" });\n\n    return transcribeResult;\n  }\n\n  /**\n   * Create a streaming transcription session\n   *\n   * Transcribes audio in real-time by processing chunks at regular intervals.\n   * Perfect for live captioning, call transcription, or real-time subtitles.\n   *\n   * @param options - Streaming options\n   * @returns Streaming session controller\n   *\n   * @example\n   * ```ts\n   * const session = stt.createStreamingSession({\n   *   chunkDuration: 3000,  // Transcribe every 3 seconds\n   *   onChunk: (text, idx) => console.log(`Chunk ${idx}: ${text}`),\n   *   onTranscript: (fullText) => console.log(\"Full:\", fullText),\n   * });\n   *\n   * // Feed audio data as it comes in (Float32Array at 16kHz)\n   * session.feedAudio(audioChunk);\n   *\n   * // Or manually trigger transcription\n   * await session.flush();\n   *\n   * // Stop and get final transcript\n   * const finalText = await session.stop();\n   * ```\n   */\n  createStreamingSession(\n    options: StreamingTranscriptionOptions = {},\n  ): StreamingTranscriptionSession {\n    const {\n      chunkDuration = 3000,\n      minChunkSize = 8000, // ~0.5 seconds at 16kHz\n      onChunk,\n      onTranscript,\n      onError,\n      language,\n    } = options;\n\n    let audioBuffer: Float32Array[] = [];\n    let fullTranscript = \"\";\n    let chunkIndex = 0;\n    let intervalId: ReturnType<typeof setInterval> | null = null;\n    let isRunning = false;\n\n    const getBufferSize = (): number => {\n      return audioBuffer.reduce((sum, chunk) => sum + chunk.length, 0);\n    };\n\n    const mergeBuffer = (): Float32Array => {\n      const totalLength = getBufferSize();\n      const merged = new Float32Array(totalLength);\n      let offset = 0;\n      for (const chunk of audioBuffer) {\n        merged.set(chunk, offset);\n        offset += chunk.length;\n      }\n      return merged;\n    };\n\n    const transcribeBuffer = async (): Promise<string> => {\n      if (!this._isLoaded || getBufferSize() < minChunkSize) {\n        return \"\";\n      }\n\n      const audio = mergeBuffer();\n      audioBuffer = []; // Clear buffer\n\n      try {\n        const result = await this.transcribe(audio, { language });\n        const text = result.text.trim();\n\n        if (text) {\n          chunkIndex++;\n          onChunk?.(text, chunkIndex);\n\n          // Append to full transcript\n          fullTranscript = fullTranscript + (fullTranscript ? \" \" : \"\") + text;\n          onTranscript?.(fullTranscript);\n        }\n\n        return text;\n      } catch (e: any) {\n        onError?.(e.message || \"Transcription failed\");\n        return \"\";\n      }\n    };\n\n    let aborted = false;\n\n    const session: StreamingTranscriptionSession = {\n      feedAudio: (audio: Float32Array) => {\n        if (!aborted) {\n          audioBuffer.push(audio);\n        }\n      },\n\n      flush: async () => {\n        if (aborted) return \"\";\n        return transcribeBuffer();\n      },\n\n      start: () => {\n        if (isRunning || aborted) return;\n        isRunning = true;\n\n        intervalId = setInterval(async () => {\n          if (isRunning && !aborted) {\n            await transcribeBuffer();\n          }\n        }, chunkDuration);\n      },\n\n      stop: async () => {\n        isRunning = false;\n\n        if (intervalId) {\n          clearInterval(intervalId);\n          intervalId = null;\n        }\n\n        // Transcribe any remaining audio (unless aborted)\n        if (!aborted && getBufferSize() >= minChunkSize) {\n          await transcribeBuffer();\n        }\n\n        return fullTranscript;\n      },\n\n      abort: () => {\n        // Immediately stop without final transcription\n        aborted = true;\n        isRunning = false;\n\n        if (intervalId) {\n          clearInterval(intervalId);\n          intervalId = null;\n        }\n\n        audioBuffer = [];\n      },\n\n      isRunning: () => isRunning,\n\n      getTranscript: () => fullTranscript,\n\n      getChunkCount: () => chunkIndex,\n\n      reset: () => {\n        audioBuffer = [];\n        fullTranscript = \"\";\n        chunkIndex = 0;\n      },\n    };\n\n    return session;\n  }\n\n  /**\n   * Dispose of resources\n   */\n  dispose(): void {\n    this.pipeline = null;\n    this._isLoaded = false;\n    this.loadPromise = null;\n  }\n}\n"],"mappings":"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"}

package/dist/{tools-IYPrqoek.mjs → tools-Bi1P7Xoy.mjs}

@@ -1,4 +1,4 @@
-import { n as zodToJsonSchema } from "./utils-CkB4Roi6.mjs";
+import { n as zodToJsonSchema } from "./utils-CZBZ8dgR.mjs";
 import { z } from "zod";
 
 //#region src/core/docs.ts
@@ -563,4 +563,4 @@ const docsTool = defineTool({
 
 //#endregion
 export { getToolDefinitions as a, setToolContext as c, getTool as i, executeToolCall as n, loadProjectTools as o, formatToolsForPrompt as r, parseToolCall as s, defineTool as t };
-//# sourceMappingURL=tools-IYPrqoek.mjs.map
+//# sourceMappingURL=tools-Bi1P7Xoy.mjs.map

package/dist/{tools-IYPrqoek.mjs.map → tools-Bi1P7Xoy.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"tools-IYPrqoek.mjs","names":["GERBIL_DOCS: Record<string, string>","matches: string[]","toolContext: ToolContext | null","results: LoadedToolResult[]"],"sources":["../src/core/docs.ts","../src/core/tools.ts"],"sourcesContent":["/**\n * Gerbil Documentation Content\n *\n * Documentation strings used by the gerbil_docs tool\n * for answering questions about Gerbil features.\n */\n\nexport const GERBIL_DOCS: Record<string, string> = {\n  // Core\n  quickstart: `Gerbil Quick Start:\n\\`\\`\\`typescript\nimport { Gerbil } from \"gerbil\";\n\nconst g = new Gerbil();\nawait g.loadModel(\"qwen3-0.6b\");\n\n// Generate text\nconst result = await g.generate(\"Write a haiku\");\nconsole.log(result.text);\n\n// Stream responses\nfor await (const chunk of g.stream(\"Tell me a story\")) {\n  process.stdout.write(chunk);\n}\n\\`\\`\\``,\n\n  generate: `Generate text with options:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(prompt, {\n  maxTokens: 256,      // Max tokens to generate\n  temperature: 0.7,    // 0-2, higher = more creative\n  topP: 0.9,           // Nucleus sampling\n  topK: 50,            // Top-k sampling\n  thinking: false,     // Enable reasoning mode (Qwen3)\n  system: \"You are...\", // System prompt\n});\n\n// Result contains:\nresult.text           // Generated text\nresult.thinking       // Reasoning (if thinking=true)\nresult.tokensGenerated\nresult.tokensPerSecond\nresult.totalTime\n\\`\\`\\``,\n\n  stream: `Streaming responses:\n\\`\\`\\`typescript\nfor await (const chunk of gerbil.stream(\"Hello\")) {\n  process.stdout.write(chunk);\n}\n\n// With options\nconst stream = gerbil.stream(\"Explain React\", {\n  maxTokens: 500,\n  onToken: (token) => console.log(token),\n});\n\\`\\`\\``,\n\n  json: `Structured JSON output with Zod validation:\n\\`\\`\\`typescript\nimport { z } from \"zod\";\n\nconst PersonSchema = z.object({\n  name: z.string(),\n  age: z.number(),\n  city: z.string(),\n});\n\nconst data = await gerbil.json(\"Extract: John is 32 and lives in NYC\", {\n  schema: PersonSchema,\n  retries: 3,          // Retry on validation failure\n  temperature: 0.3,    // Lower = more consistent\n});\n// { name: \"John\", age: 32, city: \"NYC\" }\n\\`\\`\\``,\n\n  thinking: `Thinking mode (chain-of-thought reasoning) - Qwen3 models:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(\"What is 127 × 43?\", {\n  thinking: true,\n});\n\nconsole.log(result.thinking);\n// \"Let me calculate step by step: 127 × 43 = 127 × 40 + 127 × 3...\"\n\nconsole.log(result.text);\n// \"5461\"\n\\`\\`\\`\n\nEnable in chat with /no_think or /think commands, or enable_thinking parameter.`,\n\n  embed: `Generate embeddings:\n\\`\\`\\`typescript\n// Single text\nconst { vector } = await gerbil.embed(\"Hello world\");\n// vector: number[] (384 dimensions by default)\n\n// Batch\nconst results = await gerbil.embedBatch([\"Hello\", \"World\"]);\n\\`\\`\\``,\n\n  // Models\n  models: `Available models:\n\n| Model | Size | Best For |\n|-------|------|----------|\n| qwen3-0.6b | ~400MB | General use, reasoning (thinking mode) |\n| qwen2.5-0.5b | ~350MB | Fast and capable |\n| qwen2.5-coder-0.5b | ~400MB | Code generation |\n| smollm2-360m | ~250MB | Very fast, simple tasks |\n| smollm2-135m | ~100MB | Fastest, basic generation |\n| phi-3-mini | ~2.1GB | High quality, larger |\n\nLoad any HuggingFace model:\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"hf:org/model\");\nawait gerbil.loadModel(\"onnx-community/Qwen3-0.6B-ONNX\");\n\\`\\`\\``,\n\n  load: `Loading models:\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"qwen3-0.6b\", {\n  device: \"auto\",     // \"auto\" | \"gpu\" | \"cpu\"\n  dtype: \"q4\",        // \"q4\" | \"q8\" | \"fp16\" | \"fp32\"\n  onProgress: (p) => {\n    console.log(p.status, p.progress, p.file);\n  },\n});\n\\`\\`\\``,\n\n  // AI SDK\n  \"ai-sdk\": `Vercel AI SDK v5 integration:\n\\`\\`\\`typescript\nimport { generateText, streamText } from \"ai\";\nimport { gerbil } from \"gerbil/ai\";\n\n// Generate\nconst { text } = await generateText({\n  model: gerbil(\"qwen3-0.6b\"),\n  prompt: \"Write a commit message\",\n});\n\n// Stream\nconst stream = streamText({\n  model: gerbil(\"qwen3-0.6b\"),\n  prompt: \"Explain React hooks\",\n});\n\nfor await (const chunk of stream.textStream) {\n  process.stdout.write(chunk);\n}\n\n// With thinking mode\nconst { text } = await generateText({\n  model: gerbil(\"qwen3-0.6b\", { thinking: true }),\n  prompt: \"What is 127 × 43?\",\n});\n\\`\\`\\``,\n\n  // Frameworks\n  next: `Next.js App Router integration:\n\\`\\`\\`typescript\n// app/api/chat/route.ts\nimport { gerbil } from \"gerbil/next\";\n\nexport const POST = gerbil.handler({ \n  model: \"qwen3-0.6b\",\n  maxTokens: 500,\n});\n\\`\\`\\``,\n\n  express: `Express.js integration:\n\\`\\`\\`typescript\nimport express from \"express\";\nimport { gerbil } from \"gerbil/express\";\n\nconst app = express();\napp.use(\"/ai\", gerbil()());\n\n// Endpoints created:\n// POST /ai/generate - Generate text\n// POST /ai/stream   - Stream text\n// POST /ai/json     - Structured output\n// POST /ai/embed    - Embeddings\n\\`\\`\\``,\n\n  react: `React hooks:\n\\`\\`\\`typescript\nimport { useGerbil, useChat } from \"gerbil/react\";\n\nfunction Chat() {\n  const { generate, isLoading } = useGerbil();\n  \n  const handleSubmit = async (prompt: string) => {\n    const result = await generate(prompt);\n    console.log(result.text);\n  };\n}\n\\`\\`\\``,\n\n  hono: `Hono integration:\n\\`\\`\\`typescript\nimport { Hono } from \"hono\";\nimport { gerbil } from \"gerbil/hono\";\n\nconst app = new Hono();\napp.route(\"/ai\", await gerbil()());\n\\`\\`\\``,\n\n  langchain: `LangChain integration:\n\\`\\`\\`typescript\nimport { GerbilLLM, GerbilEmbeddings } from \"gerbil/langchain\";\n\nconst llm = new GerbilLLM({ model: \"qwen3-0.6b\" });\nconst embeddings = new GerbilEmbeddings();\n\n// Use with chains\nconst chain = new LLMChain({ llm, prompt: template });\n\\`\\`\\``,\n\n  mcp: `MCP Server for Claude Desktop & Cursor:\n\\`\\`\\`bash\ngerbil serve --mcp\n\\`\\`\\`\n\nSkills are automatically exposed as MCP tools:\n- gerbil_generate\n- gerbil_commit\n- gerbil_summarize\n- gerbil_explain\n- etc.`,\n\n  // Skills\n  skills: `Skills are reusable AI tasks with Zod validation:\n\\`\\`\\`typescript\nimport { commit, summarize, explain, review } from \"gerbil/skills\";\n\n// Generate commit message\nconst msg = await commit({ type: \"conventional\", maxLength: 72 });\n\n// Summarize content\nconst summary = await summarize({ \n  content: doc, \n  length: \"short\",\n  format: \"bullets\" \n});\n\n// Explain code\nconst explanation = await explain({ \n  content: code, \n  level: \"beginner\" \n});\n\n// Code review\nconst feedback = await review({ \n  code, \n  focus: [\"security\", \"performance\"] \n});\n\\`\\`\\`\n\nBuilt-in skills: commit, summarize, explain, review, test, translate, extract, title`,\n\n  \"define-skill\": `Create custom skills:\n\\`\\`\\`typescript\nimport { defineSkill } from \"gerbil/skills\";\nimport { z } from \"zod\";\n\nexport const sentiment = defineSkill({\n  name: \"sentiment\",\n  description: \"Analyze text sentiment\",\n  input: z.object({ \n    text: z.string(),\n    detailed: z.boolean().default(false)\n  }),\n  output: z.object({\n    sentiment: z.enum([\"positive\", \"negative\", \"neutral\"]),\n    confidence: z.number(),\n  }),\n  temperature: 0.3,\n  maxTokens: 100,\n  \n  async run({ input, gerbil }) {\n    return gerbil.json(\\`Sentiment of: \\${input.text}\\`, {\n      schema: this.output,\n    });\n  },\n});\n\\`\\`\\``,\n\n  \"load-skills\": `Load skills from files:\n\\`\\`\\`typescript\nimport { loadSkills, useSkill, listSkills } from \"gerbil/skills\";\n\n// Load from directory (*.skill.ts files)\nawait loadSkills(\"./skills\");\n\n// Use by name\nconst skill = useSkill(\"my-skill\");\nconst result = await skill({ text: \"Hello\" });\n\n// List all\nconsole.log(listSkills()); // [\"commit\", \"summarize\", ...]\n\\`\\`\\``,\n\n  // CLI\n  cli: `CLI commands:\n\\`\\`\\`bash\ngerbil \"Write a haiku\"              # Generate text\ngerbil -m qwen3-0.6b \"prompt\"       # Specify model\ngerbil --thinking \"127 × 43\"        # Enable reasoning\n\ngerbil commit                        # Git commit message\ngerbil summarize README.md           # Summarize file\ngerbil explain src/index.ts          # Explain code\n\ngerbil chat                          # Interactive chat\ngerbil chat --thinking               # With reasoning\n\ngerbil serve                         # HTTP server\ngerbil serve --mcp                   # MCP server\n\ngerbil models                        # List models\ngerbil cache                         # Show cached models\ngerbil bench                         # Benchmark\ngerbil info                          # System info\n\ngerbil repl                          # Interactive TUI\n\\`\\`\\``,\n\n  // Tools/Agents\n  tools: `Gerbil supports tool calling with Qwen3 models:\n\\`\\`\\`typescript\nimport { defineTool, executeToolCall } from \"gerbil\";\n\nconst weatherTool = defineTool({\n  name: \"get_weather\",\n  description: \"Get current weather for a city\",\n  parameters: z.object({\n    city: z.string(),\n  }),\n  execute: async ({ city }) => {\n    return \\`Weather in \\${city}: 72°F, sunny\\`;\n  },\n});\n\\`\\`\\`\n\nIn the REPL, use Agent mode (Tab → Agent) to enable tools.`,\n};\n\n/**\n * Get all available documentation topics\n */\nexport function getDocTopics(): string[] {\n  return Object.keys(GERBIL_DOCS);\n}\n\n/**\n * Search documentation by topic\n */\nexport function searchDocs(query: string): string | null {\n  const words = query.toLowerCase().split(/\\s+/);\n  const keyWords = words.filter((w) => w.length > 2);\n\n  // Direct key match first\n  for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n    const keyNorm = key.replace(/-/g, \"\");\n    for (const word of keyWords) {\n      if (keyNorm === word || key === word || keyNorm.includes(word)) {\n        return content;\n      }\n    }\n  }\n\n  // Try each word as a potential topic\n  for (const word of keyWords) {\n    for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n      if (key.includes(word) || word.includes(key.replace(/-/g, \"\"))) {\n        return content;\n      }\n    }\n  }\n\n  // Fallback: search content\n  const matches: string[] = [];\n  for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n    for (const word of keyWords) {\n      if (content.toLowerCase().includes(word)) {\n        matches.push(`## ${key}\\n${content}`);\n        break;\n      }\n    }\n  }\n\n  if (matches.length > 0) {\n    return matches.slice(0, 2).join(\"\\n\\n---\\n\\n\");\n  }\n\n  return null;\n}\n","/**\n * Tool Calling System for Gerbil\n *\n * Enables LLMs to call functions/tools during generation.\n * Compatible with Qwen3's tool calling format.\n */\n\nimport { z } from \"zod\";\nimport { getDocTopics, searchDocs } from \"./docs.js\";\nimport { zodToJsonSchema } from \"./utils.js\";\n\n// ============================================\n// Tool Context (for passing gerbil to tools)\n// ============================================\n\nexport type ToolContext = {\n  /** Generate text using the loaded model */\n  generate: (prompt: string) => Promise<string>;\n};\n\nlet toolContext: ToolContext | null = null;\n\n/**\n * Set the tool context (call this after loading a model)\n */\nexport function setToolContext(ctx: ToolContext): void {\n  toolContext = ctx;\n}\n\n/**\n * Get the tool context for use in tools\n */\nexport function getToolContext(): ToolContext | null {\n  return toolContext;\n}\n\n// ============================================\n// Tool Definition\n// ============================================\n\nexport type ToolDefinition<TParams = unknown> = {\n  /** Tool name (function name) */\n  name: string;\n\n  /** Description for the LLM */\n  description: string;\n\n  /** Zod schema for parameters */\n  parameters?: z.ZodType<TParams>;\n\n  /** The function to execute (receives params and optional context) */\n  execute: (params: TParams, ctx?: ToolContext | null) => Promise<string>;\n};\n\nexport type Tool<TParams = unknown> = {\n  definition: ToolDefinition<TParams>;\n  (params: TParams): Promise<string>;\n};\n\n// ============================================\n// Tool Registry\n// ============================================\n\nconst toolRegistry = new Map<string, Tool<any>>();\n\n/**\n * Define a tool\n */\nexport function defineTool<TParams>(def: ToolDefinition<TParams>): Tool<TParams> {\n  const tool = async (params: TParams): Promise<string> => {\n    // Validate params if schema provided\n    if (def.parameters) {\n      const parsed = def.parameters.parse(params);\n      return def.execute(parsed, toolContext);\n    }\n    return def.execute(params, toolContext);\n  };\n\n  (tool as Tool<TParams>).definition = def;\n\n  // Auto-register\n  toolRegistry.set(def.name, tool as Tool<any>);\n\n  return tool as Tool<TParams>;\n}\n\n/**\n * Get tool by name\n */\nexport function getTool(name: string): Tool<any> | undefined {\n  return toolRegistry.get(name);\n}\n\n/**\n * List all tools\n */\nexport function listTools(): string[] {\n  return Array.from(toolRegistry.keys());\n}\n\n/**\n * Get all tool definitions for prompt injection\n */\nexport function getToolDefinitions(): ToolDefinition<any>[] {\n  return Array.from(toolRegistry.values()).map((t) => t.definition);\n}\n\nexport type LoadedToolResult = {\n  name: string;\n  loaded: boolean;\n  error?: string;\n  path: string;\n};\n\n/**\n * Simple tool config (no imports needed in tool files)\n */\nexport type SimpleToolConfig = {\n  name: string;\n  description: string;\n  execute: (params: Record<string, any>) => Promise<string> | string;\n};\n\n/**\n * Load tools from a directory\n * Tools are simple .ts files with a default export config object\n * No module imports - we eval the execute function directly\n */\nexport async function loadTools(dir: string): Promise<LoadedToolResult[]> {\n  const fs = await import(\"node:fs\");\n  const pathModule = await import(\"node:path\");\n\n  if (!fs.existsSync(dir)) {\n    return [];\n  }\n\n  const files = fs.readdirSync(dir).filter((f) => f.endsWith(\".tool.ts\") || f.endsWith(\".tool.js\"));\n  const results: LoadedToolResult[] = [];\n\n  for (const file of files) {\n    const filePath = pathModule.join(dir, file);\n    const toolName = file.replace(/\\.tool\\.(ts|js)$/, \"\");\n\n    try {\n      // Read file content directly\n      const content = fs.readFileSync(filePath, \"utf-8\");\n\n      // Extract the config object using simple parsing\n      const config = parseToolFile(content, toolName);\n\n      if (config) {\n        // Register the tool\n        defineTool({\n          name: config.name,\n          description: config.description,\n          execute: async (params, ctx) => {\n            // Project tools may or may not accept ctx parameter\n            const executeFn = config.execute as any;\n            const result = await executeFn(params, ctx);\n            return typeof result === \"string\" ? result : String(result);\n          },\n        });\n        results.push({ name: config.name, loaded: true, path: filePath });\n      } else {\n        results.push({\n          name: toolName,\n          loaded: false,\n          error: \"Could not parse tool config\",\n          path: filePath,\n        });\n      }\n    } catch (e) {\n      const errorMsg = e instanceof Error ? e.message.split(\"\\n\")[0] : String(e);\n      results.push({ name: toolName, loaded: false, error: errorMsg, path: filePath });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Parse a simple tool file and extract the config\n * Expected format:\n * ```\n * export default {\n *   name: \"tool_name\",\n *   description: \"...\",\n *   execute: async (params) => { ... }\n * }\n * ```\n */\nfunction parseToolFile(content: string, fallbackName: string): SimpleToolConfig | null {\n  try {\n    // Remove TypeScript type annotations for eval\n    let cleaned = content\n      .replace(/:\\s*\\{[^}]+\\}/g, \"\") // Remove type objects like : { theme?: string }\n      .replace(/:\\s*Record<[^>]+>/g, \"\") // Remove Record types\n      .replace(/:\\s*string\\b/g, \"\")\n      .replace(/:\\s*number\\b/g, \"\")\n      .replace(/:\\s*boolean\\b/g, \"\")\n      .replace(/:\\s*any\\b/g, \"\")\n      .replace(/:\\s*Promise<[^>]+>/g, \"\")\n      .replace(/export\\s+default\\s+/, \"return \");\n\n    // Remove comments\n    cleaned = cleaned.replace(/\\/\\/.*$/gm, \"\").replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n\n    // Wrap in function and evaluate\n    const fn = new Function(cleaned);\n    const config = fn();\n\n    if (config && typeof config === \"object\" && config.name && config.execute) {\n      return {\n        name: config.name || fallbackName,\n        description: config.description || \"No description\",\n        execute: config.execute,\n      };\n    }\n    return null;\n  } catch (_e) {\n    return null;\n  }\n}\n\n/**\n * Load tools from project .gerbil/tools directory\n */\nexport async function loadProjectTools(): Promise<LoadedToolResult[]> {\n  const pathModule = await import(\"node:path\");\n  const toolsDir = pathModule.join(process.cwd(), \".gerbil\", \"tools\");\n  return loadTools(toolsDir);\n}\n\n// Re-export for backwards compatibility\nexport { zodToJsonSchema } from \"./utils.js\";\n\n/**\n * Format tools for Qwen3 prompt\n */\nexport function formatToolsForPrompt(tools: ToolDefinition<any>[]): string {\n  if (tools.length === 0) {\n    return \"\";\n  }\n\n  const toolDefs = tools\n    .map((t) => {\n      const params = t.parameters\n        ? zodToJsonSchema(t.parameters)\n        : { type: \"object\", properties: {} };\n      return `## ${t.name}\n\nDescription: ${t.description}\nParameters: ${JSON.stringify(params, null, 2)}`;\n    })\n    .join(\"\\n\\n\");\n\n  return `You are a helpful assistant with access to tools.\n\n# Tools\n\n${toolDefs}\n\n## How to call tools\n\nTo call a tool, use this exact format:\n<tool_call>\n{\"name\": \"tool_name\", \"arguments\": {\"param\": \"value\"}}\n</tool_call>\n\nWhen the user asks about Gerbil (documentation, features, how to use), call gerbil_docs with a topic like: tools, skills, ai-sdk, next, express, generate, stream, models, cli.\n\nFor other questions, respond normally without calling tools.`;\n}\n\n/**\n * Parse tool call from response\n */\nexport function parseToolCall(response: string): { tool: string; params: any } | null {\n  try {\n    // Try <tool_call> format first (Qwen style)\n    const toolCallMatch = response.match(/<tool_call>\\s*([\\s\\S]*?)\\s*<\\/tool_call>/);\n    if (toolCallMatch) {\n      const parsed = JSON.parse(toolCallMatch[1]);\n      if (parsed.name) {\n        return { tool: parsed.name, params: parsed.arguments || {} };\n      }\n    }\n\n    // Fallback: look for {\"name\": \"...\", \"arguments\": ...} pattern\n    const nameArgsMatch = response.match(\n      /\\{\\s*\"name\"\\s*:\\s*\"([^\"]+)\"[^}]*\"arguments\"\\s*:\\s*(\\{[^}]*\\})/,\n    );\n    if (nameArgsMatch) {\n      return { tool: nameArgsMatch[1], params: JSON.parse(nameArgsMatch[2]) };\n    }\n\n    // Fallback: {\"tool\": \"...\", \"params\": ...} pattern\n    const toolParamsMatch = response.match(\n      /\\{\\s*\"tool\"\\s*:\\s*\"([^\"]+)\"[^}]*\"params\"\\s*:\\s*(\\{[^}]*\\})/,\n    );\n    if (toolParamsMatch) {\n      return { tool: toolParamsMatch[1], params: JSON.parse(toolParamsMatch[2]) };\n    }\n\n    // Simple fallback\n    const simpleMatch = response.match(/\\{\\s*\"(?:tool|name)\"\\s*:\\s*\"([^\"]+)\"/);\n    if (simpleMatch) {\n      return { tool: simpleMatch[1], params: {} };\n    }\n  } catch {}\n  return null;\n}\n\n/**\n * Execute a tool call\n */\nexport async function executeToolCall(toolName: string, params: any): Promise<string> {\n  const tool = getTool(toolName);\n  if (!tool) {\n    return `Error: Unknown tool \"${toolName}\"`;\n  }\n\n  try {\n    return await tool(params);\n  } catch (e) {\n    return `Error executing ${toolName}: ${e}`;\n  }\n}\n\n// ============================================\n// Built-in Tools\n// ============================================\n\n/**\n * Docs tool - searches gerbil documentation\n * Documentation content is in core/docs.ts\n */\nexport const docsTool = defineTool({\n  name: \"gerbil_docs\",\n  description:\n    \"Search Gerbil documentation for information about features, API, integrations, skills, and usage examples\",\n  parameters: z.object({\n    query: z\n      .string()\n      .optional()\n      .default(\"quickstart\")\n      .describe(\n        \"Topic: quickstart, generate, stream, json, thinking, embed, models, ai-sdk, next, express, react, skills, define-skill, cli, tools\",\n      ),\n  }),\n  execute: async ({ query = \"quickstart\" }) => {\n    const result = searchDocs(query);\n    if (result) {\n      return result;\n    }\n    const topics = getDocTopics().join(\", \");\n    return `No documentation found for \"${query}\". Available topics: ${topics}`;\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"tools-Bi1P7Xoy.mjs","names":["GERBIL_DOCS: Record<string, string>","matches: string[]","toolContext: ToolContext | null","results: LoadedToolResult[]"],"sources":["../src/core/docs.ts","../src/core/tools.ts"],"sourcesContent":["/**\n * Gerbil Documentation Content\n *\n * Documentation strings used by the gerbil_docs tool\n * for answering questions about Gerbil features.\n */\n\nexport const GERBIL_DOCS: Record<string, string> = {\n  // Core\n  quickstart: `Gerbil Quick Start:\n\\`\\`\\`typescript\nimport { Gerbil } from \"gerbil\";\n\nconst g = new Gerbil();\nawait g.loadModel(\"qwen3-0.6b\");\n\n// Generate text\nconst result = await g.generate(\"Write a haiku\");\nconsole.log(result.text);\n\n// Stream responses\nfor await (const chunk of g.stream(\"Tell me a story\")) {\n  process.stdout.write(chunk);\n}\n\\`\\`\\``,\n\n  generate: `Generate text with options:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(prompt, {\n  maxTokens: 256,      // Max tokens to generate\n  temperature: 0.7,    // 0-2, higher = more creative\n  topP: 0.9,           // Nucleus sampling\n  topK: 50,            // Top-k sampling\n  thinking: false,     // Enable reasoning mode (Qwen3)\n  system: \"You are...\", // System prompt\n});\n\n// Result contains:\nresult.text           // Generated text\nresult.thinking       // Reasoning (if thinking=true)\nresult.tokensGenerated\nresult.tokensPerSecond\nresult.totalTime\n\\`\\`\\``,\n\n  stream: `Streaming responses:\n\\`\\`\\`typescript\nfor await (const chunk of gerbil.stream(\"Hello\")) {\n  process.stdout.write(chunk);\n}\n\n// With options\nconst stream = gerbil.stream(\"Explain React\", {\n  maxTokens: 500,\n  onToken: (token) => console.log(token),\n});\n\\`\\`\\``,\n\n  json: `Structured JSON output with Zod validation:\n\\`\\`\\`typescript\nimport { z } from \"zod\";\n\nconst PersonSchema = z.object({\n  name: z.string(),\n  age: z.number(),\n  city: z.string(),\n});\n\nconst data = await gerbil.json(\"Extract: John is 32 and lives in NYC\", {\n  schema: PersonSchema,\n  retries: 3,          // Retry on validation failure\n  temperature: 0.3,    // Lower = more consistent\n});\n// { name: \"John\", age: 32, city: \"NYC\" }\n\\`\\`\\``,\n\n  thinking: `Thinking mode (chain-of-thought reasoning) - Qwen3 models:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(\"What is 127 × 43?\", {\n  thinking: true,\n});\n\nconsole.log(result.thinking);\n// \"Let me calculate step by step: 127 × 43 = 127 × 40 + 127 × 3...\"\n\nconsole.log(result.text);\n// \"5461\"\n\\`\\`\\`\n\nEnable in chat with /no_think or /think commands, or enable_thinking parameter.`,\n\n  embed: `Generate embeddings:\n\\`\\`\\`typescript\n// Single text\nconst { vector } = await gerbil.embed(\"Hello world\");\n// vector: number[] (384 dimensions by default)\n\n// Batch\nconst results = await gerbil.embedBatch([\"Hello\", \"World\"]);\n\\`\\`\\``,\n\n  // Models\n  models: `Available models:\n\n| Model | Size | Best For |\n|-------|------|----------|\n| qwen3-0.6b | ~400MB | General use, reasoning (thinking mode) |\n| qwen2.5-0.5b | ~350MB | Fast and capable |\n| qwen2.5-coder-0.5b | ~400MB | Code generation |\n| smollm2-360m | ~250MB | Very fast, simple tasks |\n| smollm2-135m | ~100MB | Fastest, basic generation |\n| phi-3-mini | ~2.1GB | High quality, larger |\n\nLoad any HuggingFace model:\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"hf:org/model\");\nawait gerbil.loadModel(\"onnx-community/Qwen3-0.6B-ONNX\");\n\\`\\`\\``,\n\n  load: `Loading models:\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"qwen3-0.6b\", {\n  device: \"auto\",     // \"auto\" | \"gpu\" | \"cpu\"\n  dtype: \"q4\",        // \"q4\" | \"q8\" | \"fp16\" | \"fp32\"\n  onProgress: (p) => {\n    console.log(p.status, p.progress, p.file);\n  },\n});\n\\`\\`\\``,\n\n  // AI SDK\n  \"ai-sdk\": `Vercel AI SDK v5 integration:\n\\`\\`\\`typescript\nimport { generateText, streamText } from \"ai\";\nimport { gerbil } from \"gerbil/ai\";\n\n// Generate\nconst { text } = await generateText({\n  model: gerbil(\"qwen3-0.6b\"),\n  prompt: \"Write a commit message\",\n});\n\n// Stream\nconst stream = streamText({\n  model: gerbil(\"qwen3-0.6b\"),\n  prompt: \"Explain React hooks\",\n});\n\nfor await (const chunk of stream.textStream) {\n  process.stdout.write(chunk);\n}\n\n// With thinking mode\nconst { text } = await generateText({\n  model: gerbil(\"qwen3-0.6b\", { thinking: true }),\n  prompt: \"What is 127 × 43?\",\n});\n\\`\\`\\``,\n\n  // Frameworks\n  next: `Next.js App Router integration:\n\\`\\`\\`typescript\n// app/api/chat/route.ts\nimport { gerbil } from \"gerbil/next\";\n\nexport const POST = gerbil.handler({ \n  model: \"qwen3-0.6b\",\n  maxTokens: 500,\n});\n\\`\\`\\``,\n\n  express: `Express.js integration:\n\\`\\`\\`typescript\nimport express from \"express\";\nimport { gerbil } from \"gerbil/express\";\n\nconst app = express();\napp.use(\"/ai\", gerbil()());\n\n// Endpoints created:\n// POST /ai/generate - Generate text\n// POST /ai/stream   - Stream text\n// POST /ai/json     - Structured output\n// POST /ai/embed    - Embeddings\n\\`\\`\\``,\n\n  react: `React hooks:\n\\`\\`\\`typescript\nimport { useGerbil, useChat } from \"gerbil/react\";\n\nfunction Chat() {\n  const { generate, isLoading } = useGerbil();\n  \n  const handleSubmit = async (prompt: string) => {\n    const result = await generate(prompt);\n    console.log(result.text);\n  };\n}\n\\`\\`\\``,\n\n  hono: `Hono integration:\n\\`\\`\\`typescript\nimport { Hono } from \"hono\";\nimport { gerbil } from \"gerbil/hono\";\n\nconst app = new Hono();\napp.route(\"/ai\", await gerbil()());\n\\`\\`\\``,\n\n  langchain: `LangChain integration:\n\\`\\`\\`typescript\nimport { GerbilLLM, GerbilEmbeddings } from \"gerbil/langchain\";\n\nconst llm = new GerbilLLM({ model: \"qwen3-0.6b\" });\nconst embeddings = new GerbilEmbeddings();\n\n// Use with chains\nconst chain = new LLMChain({ llm, prompt: template });\n\\`\\`\\``,\n\n  mcp: `MCP Server for Claude Desktop & Cursor:\n\\`\\`\\`bash\ngerbil serve --mcp\n\\`\\`\\`\n\nSkills are automatically exposed as MCP tools:\n- gerbil_generate\n- gerbil_commit\n- gerbil_summarize\n- gerbil_explain\n- etc.`,\n\n  // Skills\n  skills: `Skills are reusable AI tasks with Zod validation:\n\\`\\`\\`typescript\nimport { commit, summarize, explain, review } from \"gerbil/skills\";\n\n// Generate commit message\nconst msg = await commit({ type: \"conventional\", maxLength: 72 });\n\n// Summarize content\nconst summary = await summarize({ \n  content: doc, \n  length: \"short\",\n  format: \"bullets\" \n});\n\n// Explain code\nconst explanation = await explain({ \n  content: code, \n  level: \"beginner\" \n});\n\n// Code review\nconst feedback = await review({ \n  code, \n  focus: [\"security\", \"performance\"] \n});\n\\`\\`\\`\n\nBuilt-in skills: commit, summarize, explain, review, test, translate, extract, title`,\n\n  \"define-skill\": `Create custom skills:\n\\`\\`\\`typescript\nimport { defineSkill } from \"gerbil/skills\";\nimport { z } from \"zod\";\n\nexport const sentiment = defineSkill({\n  name: \"sentiment\",\n  description: \"Analyze text sentiment\",\n  input: z.object({ \n    text: z.string(),\n    detailed: z.boolean().default(false)\n  }),\n  output: z.object({\n    sentiment: z.enum([\"positive\", \"negative\", \"neutral\"]),\n    confidence: z.number(),\n  }),\n  temperature: 0.3,\n  maxTokens: 100,\n  \n  async run({ input, gerbil }) {\n    return gerbil.json(\\`Sentiment of: \\${input.text}\\`, {\n      schema: this.output,\n    });\n  },\n});\n\\`\\`\\``,\n\n  \"load-skills\": `Load skills from files:\n\\`\\`\\`typescript\nimport { loadSkills, useSkill, listSkills } from \"gerbil/skills\";\n\n// Load from directory (*.skill.ts files)\nawait loadSkills(\"./skills\");\n\n// Use by name\nconst skill = useSkill(\"my-skill\");\nconst result = await skill({ text: \"Hello\" });\n\n// List all\nconsole.log(listSkills()); // [\"commit\", \"summarize\", ...]\n\\`\\`\\``,\n\n  // CLI\n  cli: `CLI commands:\n\\`\\`\\`bash\ngerbil \"Write a haiku\"              # Generate text\ngerbil -m qwen3-0.6b \"prompt\"       # Specify model\ngerbil --thinking \"127 × 43\"        # Enable reasoning\n\ngerbil commit                        # Git commit message\ngerbil summarize README.md           # Summarize file\ngerbil explain src/index.ts          # Explain code\n\ngerbil chat                          # Interactive chat\ngerbil chat --thinking               # With reasoning\n\ngerbil serve                         # HTTP server\ngerbil serve --mcp                   # MCP server\n\ngerbil models                        # List models\ngerbil cache                         # Show cached models\ngerbil bench                         # Benchmark\ngerbil info                          # System info\n\ngerbil repl                          # Interactive TUI\n\\`\\`\\``,\n\n  // Tools/Agents\n  tools: `Gerbil supports tool calling with Qwen3 models:\n\\`\\`\\`typescript\nimport { defineTool, executeToolCall } from \"gerbil\";\n\nconst weatherTool = defineTool({\n  name: \"get_weather\",\n  description: \"Get current weather for a city\",\n  parameters: z.object({\n    city: z.string(),\n  }),\n  execute: async ({ city }) => {\n    return \\`Weather in \\${city}: 72°F, sunny\\`;\n  },\n});\n\\`\\`\\`\n\nIn the REPL, use Agent mode (Tab → Agent) to enable tools.`,\n};\n\n/**\n * Get all available documentation topics\n */\nexport function getDocTopics(): string[] {\n  return Object.keys(GERBIL_DOCS);\n}\n\n/**\n * Search documentation by topic\n */\nexport function searchDocs(query: string): string | null {\n  const words = query.toLowerCase().split(/\\s+/);\n  const keyWords = words.filter((w) => w.length > 2);\n\n  // Direct key match first\n  for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n    const keyNorm = key.replace(/-/g, \"\");\n    for (const word of keyWords) {\n      if (keyNorm === word || key === word || keyNorm.includes(word)) {\n        return content;\n      }\n    }\n  }\n\n  // Try each word as a potential topic\n  for (const word of keyWords) {\n    for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n      if (key.includes(word) || word.includes(key.replace(/-/g, \"\"))) {\n        return content;\n      }\n    }\n  }\n\n  // Fallback: search content\n  const matches: string[] = [];\n  for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n    for (const word of keyWords) {\n      if (content.toLowerCase().includes(word)) {\n        matches.push(`## ${key}\\n${content}`);\n        break;\n      }\n    }\n  }\n\n  if (matches.length > 0) {\n    return matches.slice(0, 2).join(\"\\n\\n---\\n\\n\");\n  }\n\n  return null;\n}\n","/**\n * Tool Calling System for Gerbil\n *\n * Enables LLMs to call functions/tools during generation.\n * Compatible with Qwen3's tool calling format.\n */\n\nimport { z } from \"zod\";\nimport { getDocTopics, searchDocs } from \"./docs.js\";\nimport { zodToJsonSchema } from \"./utils.js\";\n\n// ============================================\n// Tool Context (for passing gerbil to tools)\n// ============================================\n\nexport type ToolContext = {\n  /** Generate text using the loaded model */\n  generate: (prompt: string) => Promise<string>;\n};\n\nlet toolContext: ToolContext | null = null;\n\n/**\n * Set the tool context (call this after loading a model)\n */\nexport function setToolContext(ctx: ToolContext): void {\n  toolContext = ctx;\n}\n\n/**\n * Get the tool context for use in tools\n */\nexport function getToolContext(): ToolContext | null {\n  return toolContext;\n}\n\n// ============================================\n// Tool Definition\n// ============================================\n\nexport type ToolDefinition<TParams = unknown> = {\n  /** Tool name (function name) */\n  name: string;\n\n  /** Description for the LLM */\n  description: string;\n\n  /** Zod schema for parameters */\n  parameters?: z.ZodType<TParams>;\n\n  /** The function to execute (receives params and optional context) */\n  execute: (params: TParams, ctx?: ToolContext | null) => Promise<string>;\n};\n\nexport type Tool<TParams = unknown> = {\n  definition: ToolDefinition<TParams>;\n  (params: TParams): Promise<string>;\n};\n\n// ============================================\n// Tool Registry\n// ============================================\n\nconst toolRegistry = new Map<string, Tool<any>>();\n\n/**\n * Define a tool\n */\nexport function defineTool<TParams>(def: ToolDefinition<TParams>): Tool<TParams> {\n  const tool = async (params: TParams): Promise<string> => {\n    // Validate params if schema provided\n    if (def.parameters) {\n      const parsed = def.parameters.parse(params);\n      return def.execute(parsed, toolContext);\n    }\n    return def.execute(params, toolContext);\n  };\n\n  (tool as Tool<TParams>).definition = def;\n\n  // Auto-register\n  toolRegistry.set(def.name, tool as Tool<any>);\n\n  return tool as Tool<TParams>;\n}\n\n/**\n * Get tool by name\n */\nexport function getTool(name: string): Tool<any> | undefined {\n  return toolRegistry.get(name);\n}\n\n/**\n * List all tools\n */\nexport function listTools(): string[] {\n  return Array.from(toolRegistry.keys());\n}\n\n/**\n * Get all tool definitions for prompt injection\n */\nexport function getToolDefinitions(): ToolDefinition<any>[] {\n  return Array.from(toolRegistry.values()).map((t) => t.definition);\n}\n\nexport type LoadedToolResult = {\n  name: string;\n  loaded: boolean;\n  error?: string;\n  path: string;\n};\n\n/**\n * Simple tool config (no imports needed in tool files)\n */\nexport type SimpleToolConfig = {\n  name: string;\n  description: string;\n  execute: (params: Record<string, any>) => Promise<string> | string;\n};\n\n/**\n * Load tools from a directory\n * Tools are simple .ts files with a default export config object\n * No module imports - we eval the execute function directly\n */\nexport async function loadTools(dir: string): Promise<LoadedToolResult[]> {\n  const fs = await import(\"node:fs\");\n  const pathModule = await import(\"node:path\");\n\n  if (!fs.existsSync(dir)) {\n    return [];\n  }\n\n  const files = fs.readdirSync(dir).filter((f) => f.endsWith(\".tool.ts\") || f.endsWith(\".tool.js\"));\n  const results: LoadedToolResult[] = [];\n\n  for (const file of files) {\n    const filePath = pathModule.join(dir, file);\n    const toolName = file.replace(/\\.tool\\.(ts|js)$/, \"\");\n\n    try {\n      // Read file content directly\n      const content = fs.readFileSync(filePath, \"utf-8\");\n\n      // Extract the config object using simple parsing\n      const config = parseToolFile(content, toolName);\n\n      if (config) {\n        // Register the tool\n        defineTool({\n          name: config.name,\n          description: config.description,\n          execute: async (params, ctx) => {\n            // Project tools may or may not accept ctx parameter\n            const executeFn = config.execute as any;\n            const result = await executeFn(params, ctx);\n            return typeof result === \"string\" ? result : String(result);\n          },\n        });\n        results.push({ name: config.name, loaded: true, path: filePath });\n      } else {\n        results.push({\n          name: toolName,\n          loaded: false,\n          error: \"Could not parse tool config\",\n          path: filePath,\n        });\n      }\n    } catch (e) {\n      const errorMsg = e instanceof Error ? e.message.split(\"\\n\")[0] : String(e);\n      results.push({ name: toolName, loaded: false, error: errorMsg, path: filePath });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Parse a simple tool file and extract the config\n * Expected format:\n * ```\n * export default {\n *   name: \"tool_name\",\n *   description: \"...\",\n *   execute: async (params) => { ... }\n * }\n * ```\n */\nfunction parseToolFile(content: string, fallbackName: string): SimpleToolConfig | null {\n  try {\n    // Remove TypeScript type annotations for eval\n    let cleaned = content\n      .replace(/:\\s*\\{[^}]+\\}/g, \"\") // Remove type objects like : { theme?: string }\n      .replace(/:\\s*Record<[^>]+>/g, \"\") // Remove Record types\n      .replace(/:\\s*string\\b/g, \"\")\n      .replace(/:\\s*number\\b/g, \"\")\n      .replace(/:\\s*boolean\\b/g, \"\")\n      .replace(/:\\s*any\\b/g, \"\")\n      .replace(/:\\s*Promise<[^>]+>/g, \"\")\n      .replace(/export\\s+default\\s+/, \"return \");\n\n    // Remove comments\n    cleaned = cleaned.replace(/\\/\\/.*$/gm, \"\").replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n\n    // Wrap in function and evaluate\n    const fn = new Function(cleaned);\n    const config = fn();\n\n    if (config && typeof config === \"object\" && config.name && config.execute) {\n      return {\n        name: config.name || fallbackName,\n        description: config.description || \"No description\",\n        execute: config.execute,\n      };\n    }\n    return null;\n  } catch (_e) {\n    return null;\n  }\n}\n\n/**\n * Load tools from project .gerbil/tools directory\n */\nexport async function loadProjectTools(): Promise<LoadedToolResult[]> {\n  const pathModule = await import(\"node:path\");\n  const toolsDir = pathModule.join(process.cwd(), \".gerbil\", \"tools\");\n  return loadTools(toolsDir);\n}\n\n// Re-export for backwards compatibility\nexport { zodToJsonSchema } from \"./utils.js\";\n\n/**\n * Format tools for Qwen3 prompt\n */\nexport function formatToolsForPrompt(tools: ToolDefinition<any>[]): string {\n  if (tools.length === 0) {\n    return \"\";\n  }\n\n  const toolDefs = tools\n    .map((t) => {\n      const params = t.parameters\n        ? zodToJsonSchema(t.parameters)\n        : { type: \"object\", properties: {} };\n      return `## ${t.name}\n\nDescription: ${t.description}\nParameters: ${JSON.stringify(params, null, 2)}`;\n    })\n    .join(\"\\n\\n\");\n\n  return `You are a helpful assistant with access to tools.\n\n# Tools\n\n${toolDefs}\n\n## How to call tools\n\nTo call a tool, use this exact format:\n<tool_call>\n{\"name\": \"tool_name\", \"arguments\": {\"param\": \"value\"}}\n</tool_call>\n\nWhen the user asks about Gerbil (documentation, features, how to use), call gerbil_docs with a topic like: tools, skills, ai-sdk, next, express, generate, stream, models, cli.\n\nFor other questions, respond normally without calling tools.`;\n}\n\n/**\n * Parse tool call from response\n */\nexport function parseToolCall(response: string): { tool: string; params: any } | null {\n  try {\n    // Try <tool_call> format first (Qwen style)\n    const toolCallMatch = response.match(/<tool_call>\\s*([\\s\\S]*?)\\s*<\\/tool_call>/);\n    if (toolCallMatch) {\n      const parsed = JSON.parse(toolCallMatch[1]);\n      if (parsed.name) {\n        return { tool: parsed.name, params: parsed.arguments || {} };\n      }\n    }\n\n    // Fallback: look for {\"name\": \"...\", \"arguments\": ...} pattern\n    const nameArgsMatch = response.match(\n      /\\{\\s*\"name\"\\s*:\\s*\"([^\"]+)\"[^}]*\"arguments\"\\s*:\\s*(\\{[^}]*\\})/,\n    );\n    if (nameArgsMatch) {\n      return { tool: nameArgsMatch[1], params: JSON.parse(nameArgsMatch[2]) };\n    }\n\n    // Fallback: {\"tool\": \"...\", \"params\": ...} pattern\n    const toolParamsMatch = response.match(\n      /\\{\\s*\"tool\"\\s*:\\s*\"([^\"]+)\"[^}]*\"params\"\\s*:\\s*(\\{[^}]*\\})/,\n    );\n    if (toolParamsMatch) {\n      return { tool: toolParamsMatch[1], params: JSON.parse(toolParamsMatch[2]) };\n    }\n\n    // Simple fallback\n    const simpleMatch = response.match(/\\{\\s*\"(?:tool|name)\"\\s*:\\s*\"([^\"]+)\"/);\n    if (simpleMatch) {\n      return { tool: simpleMatch[1], params: {} };\n    }\n  } catch {}\n  return null;\n}\n\n/**\n * Execute a tool call\n */\nexport async function executeToolCall(toolName: string, params: any): Promise<string> {\n  const tool = getTool(toolName);\n  if (!tool) {\n    return `Error: Unknown tool \"${toolName}\"`;\n  }\n\n  try {\n    return await tool(params);\n  } catch (e) {\n    return `Error executing ${toolName}: ${e}`;\n  }\n}\n\n// ============================================\n// Built-in Tools\n// ============================================\n\n/**\n * Docs tool - searches gerbil documentation\n * Documentation content is in core/docs.ts\n */\nexport const docsTool = defineTool({\n  name: \"gerbil_docs\",\n  description:\n    \"Search Gerbil documentation for information about features, API, integrations, skills, and usage examples\",\n  parameters: z.object({\n    query: z\n      .string()\n      .optional()\n      .default(\"quickstart\")\n      .describe(\n        \"Topic: quickstart, generate, stream, json, thinking, embed, models, ai-sdk, next, express, react, skills, define-skill, cli, tools\",\n      ),\n  }),\n  execute: async ({ query = \"quickstart\" }) => {\n    const result = searchDocs(query);\n    if (result) {\n      return result;\n    }\n    const topics = getDocTopics().join(\", \");\n    return `No documentation found for \"${query}\". Available topics: ${topics}`;\n  },\n});\n"],"mappings":"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"}