let _silkWasmPromise: Promise<SilkWasm | null> | null = null;

/** Lazy-load the silk-wasm module (singleton cache; returns null on failure). */

export function loadSilkWasm(): Promise<SilkWasm | null> {

function loadSilkWasm(): Promise<SilkWasm | null> {

if (_silkWasmPromise) {

return _silkWasmPromise;

}

}

/** Encode PCM s16le data into SILK format. */

export async function pcmToSilk(

async function pcmToSilk(

pcmBuffer: Buffer,

sampleRate: number,

): Promise<{ silkBuffer: Buffer; duration: number }> {

}

/** Use ffmpeg to convert any audio to mono 24 kHz PCM s16le. */

export function ffmpegToPCM(

function ffmpegToPCM(

ffmpegCmd: string,

inputPath: string,

sampleRate: number = 24000,

}

/** Decode MP3 to PCM via mpg123-decoder WASM (fallback when ffmpeg is unavailable). */

export async function wasmDecodeMp3ToPCM(buf: Buffer, targetRate: number): Promise<Buffer | null> {

async function wasmDecodeMp3ToPCM(buf: Buffer, targetRate: number): Promise<Buffer | null> {

try {

const { MPEGDecoder } = await import("mpg123-decoder");

debugLog(`[audio-convert] WASM MP3 decode: size=${buf.length} bytes`);

* Normalise an identifier so it is safe to embed in a filename.

* Keeps alphanumerics, dot, underscore, dash; everything else becomes `_`.

*/

export function safeName(id: string): string {

function safeName(id: string): string {

return id.replace(/[^a-zA-Z0-9._-]/g, "_");

}

}

/** Default dimensions used when probing fails. */

export const DEFAULT_IMAGE_SIZE: ImageSize = { width: 512, height: 512 };

const DEFAULT_IMAGE_SIZE: ImageSize = { width: 512, height: 512 };

/**

* Parse image dimensions from the PNG header.

}

/** Parse image dimensions from a Base64 data URL. */

export function getImageSizeFromDataUrl(dataUrl: string): ImageSize | null {

function getImageSizeFromDataUrl(dataUrl: string): ImageSize | null {

try {

// Format: data:image/png;base64,xxxxx

const matches = dataUrl.match(/^data:image\/[^;]+;base64,(.+)$/);

* `saveMediaBuffer(..., "outbound", ...)`) or `inbound/`, while still keeping

* the check anchored to a single, well-known directory.

*/

export function getOpenClawMediaDir(): string {

function getOpenClawMediaDir(): string {

return path.join(getHomeDir(), ".openclaw", "media");

}

// ---- Tilde expansion and path normalization ----

/** Expand `~` to the current user's home directory. */

export function expandTilde(p: string): string {

function expandTilde(p: string): string {

if (!p) {

return p;

}