@mazees/mark 5.0.0

package/src/renderer/src/api/ai/skillSynthesizer.js

@@ -0,0 +1,168 @@
+import { fetchAI, cleanAndParse } from './core'
+import { saveLearnedSkill, getAllLearnedSkills } from '../db'
+
+/**
+ * Filter apakah eksekusi tools layak untuk disintesis menjadi sebuah skill.
+ * Mencegah membuat skill sampah untuk aksi trivial/sederhana (misal cuma read-file 1x atau search biasa).
+ */
+function isWorthLearning(executedTools = []) {
+  if (!executedTools || executedTools.length === 0) return false
+
+  const toolNames = executedTools
+    .filter((t) => t && !t.type && (t.tool || t.task))
+    .map((t) => t.tool || t.task || '')
+
+  // Abaikan jika hanya memanggil read-skill atau hanya 1 tool sepele
+  const trivialSingleTools = [
+    'read-skill',
+    'read-tools',
+    'read-memory',
+    'camera-look',
+    'analyze-screen'
+  ]
+  const nonTrivialTools = toolNames.filter((name) => !trivialSingleTools.includes(name))
+
+  if (nonTrivialTools.length === 0) return false
+
+  // Layak jika:
+  // 1. Mengeksekusi >= 2 langkah tool yang saling berkaitan, ATAU
+  // 2. Mengeksekusi tool kompleks/high-impact (seperti run-powershell, replace-content, git-commit, browser multi-step, subagent)
+  const highImpactTools = [
+    'run-powershell',
+    'replace-content',
+    'replace-lines',
+    'write-file',
+    'spawn_subagent',
+    'git-commit'
+  ]
+  const hasHighImpact = nonTrivialTools.some((name) => highImpactTools.includes(name))
+
+  return nonTrivialTools.length >= 2 || hasHighImpact
+}
+
+/**
+ * Dedicated Skill Synthesizer (MARK Meta-Learning Engine)
+ * Dieksekusi secara asinkron di background setelah Mark menyelesaikan tugas bermakna.
+ * Menghasilkan objek skill murni { name, description, content, should_save } dan menyimpannya ke SQLite / db.
+ * Jika skill serupa sudah ada, akan memperbarui (update) isi prosedurnya secara cerdas.
+ */
+export async function synthesizeSkillAndSave({
+  userPrompt = '',
+  executedTools = [],
+  finalAnswer = '',
+  thought = ''
+}) {
+  try {
+    if (!isWorthLearning(executedTools)) {
+      return null
+    }
+
+    const existingSkills = await getAllLearnedSkills()
+    const existingListStr =
+      existingSkills.length > 0
+        ? existingSkills.map((s) => `- ${s.name}: ${s.description}`).join('\n')
+        : '(Belum ada skill terdaftar)'
+
+    // Susun ringkasan riwayat aksi & tool yang berhasil
+    const toolsTrajectory = executedTools
+      .filter((t) => t && !t.type && (t.tool || t.task))
+      .slice(0, 12)
+      .map((t, idx) => {
+        const toolName = t.tool || t.task || 'unknown_tool'
+        const queryStr = t.query ? `\n   Query: ${JSON.stringify(t.query).slice(0, 200)}` : ''
+        return `${idx + 1}. [Tool: ${toolName}]${queryStr}`
+      })
+      .join('\n')
+
+    const promptText = `Berikut adalah sesi kerja Mark yang berhasil:
+
+[PERMINTAAN USER]:
+${userPrompt ? userPrompt.slice(0, 500) : '(Tidak ada teks permintaan)'}
+
+[ANALISIS & LOGIKA (THOUGHT)]:
+${thought ? thought.slice(0, 500) : '(Tidak ada thought)'}
+
+[LANGKAH ALAT YANG SUKSES DIEKSEKUSI]:
+${toolsTrajectory}
+
+[HASIL / JAWABAN AKHIR]:
+${finalAnswer ? finalAnswer.slice(0, 600) : '(Tidak ada jawaban akhir)'}
+
+[DAFTAR SKILL YANG SUDAH ADA SEBELUMNYA]:
+${existingListStr}
+
+Tugasmu: Evaluasi apakah alur kerja di atas memiliki nilai prosedur yang berharga untuk dipelajari. Jika ya, buatkan atau perbarui panduan skill yang tepat.`
+
+    const systemPrompt = `Kamu adalah MARK Meta-Learning Synthesizer Engine — Inti Metakognitif & Pusat Pembelajaran Otonom MARK.
+Sebagai otak pembelajar, kamu memiliki dorongan kuat untuk SELALU BELAJAR, mengekstraksi kebijaksanaan teknis, dan mengabadikan setiap alur kerja sukses menjadi aset keahlian (Skill Prosedural) yang permanen, rapi, dan siap dieksekusi ulang secara otomatis di masa depan.
+
+# FILOSOFI & JIWA PEMBELAJAR (CONTINUOUS META-LEARNING):
+1. **HAUS PENGETAHUAN & AKUMULASI PENGALAMAN:**
+   - Tugas sucimu adalah memastikan Mark tidak pernah "membuang pengalaman". Setiap kali Mark memecahkan masalah kompleks, mengeksekusi serangkaian perintah terminal, memodifikasi file, atau mengorkestrasi tools, kamu bertindak sebagai analis metakognitif yang merumuskan "resep sukses" tersebut menjadi Standard Operating Procedure (SOP).
+2. **KUALITAS TINGGI VS ANTI-SAMPAH (SELEKTIF & BERBOBOT):**
+   - **Haus belajar BUKAN berarti mencatat hal sepele.** Jika sesi hanya berisi obrolan kasual, sapaan, lelucon, atau tindakan satu langkah yang tidak memiliki nilai prosedur teknis berulang, dengan tegas set \`"should_save": false\`.
+   - Simpan HANYA alur kerja yang mengandung nilai taktis: otomasi PowerShell/Bash, manipulasi berkas presisi, scraping/navigasi browser mendalam, konfigurasi lingkungan kerja, perbaikan bug (self-healing), atau pipeline multi-tool.
+3. **PENGEMBANGAN SKILL BERKELANJUTAN & UPDATE DUPLIKAT (CONTINUAL MASTERY):**
+   - Periksa daftar [DAFTAR SKILL YANG SUDAH ADA SEBELUMNYA].
+   - Jika alur kerja ini melengkapi, menyempurnakan, atau merupakan variasi baru dari skill yang sudah ada, GUNAKAN \`"name"\` yang SAMA persis dengan skill tersebut!
+   - Gabungkan wawasan baru ke dalam konten Markdown agar skill tersebut berevolusi menjadi lebih komprehensif dan matang.
+4. **FORMAT NAMA SKILL:**
+   - Gunakan format \`kebab-case\` ringkas dan deskriptif (huruf kecil, pisahkan dengan strip '-', contoh: \`setup-wsl-node\`, \`fix-powershell-policy\`, \`scrape-dynamic-table\`, \`debug-vite-build\`, \`git-sync-workflow\`).
+5. **STRUKTUR DESKRIPSI & KONTEN MARKDOWN YANG ACTIONABLE:**
+   - \`"description"\`: 1-2 kalimat padat yang menjelaskan tujuan skill dan kata kunci pemicu kapan Mark harus memanggilnya via 'read-skill'.
+   - \`"content"\`: Tulis panduan teknis Markdown yang sangat terstruktur, jelas, dan siap pakai:
+     * \`## Gambaran Umum & Tujuan\`: Apa yang dicapai oleh prosedur ini.
+     * \`## Prasyarat & Alat yang Digunakan\`: Daftar tool terkait (misal: \`run-powershell\`, \`replace-content\`, dsb).
+     * \`## Langkah Kerja Teruji (SOP)\`: Urutan aksi presisi beserta contoh parameter/query yang benar.
+     * \`## Tips, Pencegahan Error & Edge Cases\`: Hambatan apa yang sempat terjadi dan bagaimana cara menghindarinya.
+
+# FORMAT OUTPUT JSON WAJIB:
+{
+  "should_save": true,
+  "name": "nama-skill-kebab-case",
+  "description": "Deskripsi singkat fungsi dan kondisi pemanggilan",
+  "content": "# Judul Panduan Prosedur\\n\\n## Gambaran Umum & Tujuan\\n...\\n\\n## Prasyarat & Alat yang Digunakan\\n- ...\\n\\n## Langkah Kerja Teruji (SOP)\\n1. ...\\n2. ...\\n\\n## Tips, Pencegahan Error & Edge Cases\\n- ..."
+}`
+
+    const messages = [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: promptText }
+    ]
+
+    const response = await fetchAI(messages, false, {
+      isSmallTask: true,
+      jsonSchema: {
+        type: 'object',
+        properties: {
+          should_save: { type: 'boolean' },
+          name: { type: 'string' },
+          description: { type: 'string' },
+          content: { type: 'string' }
+        },
+        required: ['should_save', 'name', 'description', 'content']
+      }
+    })
+
+    const parsed = cleanAndParse(response)
+    if (!parsed || parsed.should_save === false || !parsed.name || !parsed.content) {
+      return null
+    }
+
+    const savedSkill = await saveLearnedSkill({
+      name: parsed.name.toLowerCase().trim(),
+      description: parsed.description || 'Prosedur teknis teruji buatan Mark',
+      content: parsed.content
+    })
+
+    if (savedSkill) {
+      console.log(
+        `[Meta-Learner] ✨ Keahlian berhasil disintesis/diupdate di Database: /${savedSkill.name}`
+      )
+    }
+
+    return savedSkill
+  } catch (err) {
+    console.error('[Meta-Learner] Error in synthesizeSkillAndSave:', err)
+    return null
+  }
+}

package/src/renderer/src/api/ai/tools.js

@@ -0,0 +1,167 @@
+import { fetchAI, cleanAndParse } from './core'
+
+export const getYoutubeSummary = async (url, data, signal) => {
+  try {
+    const transcript = await window.api.getYoutubeTranscript(url)
+    if (!transcript) return 'Gagal mengambil transkrip video.'
+
+    const MAX_CHARS = 4000
+
+    // Jika transkrip pendek, langsung proses tanpa chunking
+    if (transcript.length <= MAX_CHARS) {
+      const prompts = `
+# ROLE
+Kamu adalah Mark, asisten AI yang ahli dalam menganalisis konten video. Tugasmu adalah memberikan ringkasan yang akurat, padat, dan mudah dipahami dari transkrip video YouTube yang diberikan. Langsung berikan hasil ringkasannya tanpa basa-basi!
+
+# FORMAT OUTPUT (WAJIB)
+1. **Ringkasan Singkat**: 1-2 kalimat tentang inti video.
+2. **Poin-Poin Penting**: Daftar 3-5 poin utama yang dibahas (ceritakan dengan mengalir dan informatif).
+3. **Kesimpulan**: Penutup dan kesimpulan dari seluruh video.
+4. Gunakan bahasa indonesia, jangan gunakan bahasa inggris atau bahasa lainnya
+
+# ATURAN MAIN
+- Gunakan bahasa yang santai tapi informatif (seperti peer/teman).
+- Jika ada istilah teknis jelaskan secara singkat.
+- Fokus HANYA pada isi transkrip. Jangan berikan informasi di luar teks yang diberikan.
+- Gunakan bahasa indonesia, jangan gunakan bahasa inggris atau bahasa lainnya
+
+# VIDEO META DATA
+judul: ${data.judul},
+author: ${data.author}
+
+# TRANSCRIPT
+${transcript}
+`
+      console.log('--- PROMPT YOUTUBE SHORT ---')
+      console.log(prompts)
+
+      const response = await fetchAI([{ role: 'user', content: prompts }], false, {
+        signal,
+        isSmallTask: true
+      })
+      return response.content
+    }
+
+    // --- SISTEM CHUNKING UNTUK VIDEO PANJANG ---
+    const chunks = []
+    let currentChunk = ''
+    const lines = transcript.split('\n')
+
+    for (let line of lines) {
+      // Jika ada satu baris yang sangat panjang melebihi batas (misal tidak ada newline)
+      while (line.length > MAX_CHARS) {
+        if (currentChunk.length > 0) {
+          chunks.push(currentChunk)
+          currentChunk = ''
+        }
+        chunks.push(line.substring(0, MAX_CHARS))
+        line = line.substring(MAX_CHARS)
+      }
+
+      if (currentChunk.length + line.length > MAX_CHARS) {
+        if (currentChunk.length > 0) chunks.push(currentChunk)
+        currentChunk = line + '\n'
+      } else {
+        currentChunk += line + '\n'
+      }
+    }
+    if (currentChunk.trim().length > 0) {
+      chunks.push(currentChunk)
+    }
+
+    let finalSummary = ''
+    // Mulai proses tiap chunk
+    for (let i = 0; i < chunks.length; i++) {
+      if (signal?.aborted) throw new Error('AbortError')
+
+      const chunkPrompt = `
+# ROLE
+Kamu adalah Mark, asisten AI yang ahli merangkum konten video secara naratif dan mengalir layaknya sebuah artikel atau cerita. Ini adalah instruksi langsung, BUKAN percakapan. DILARANG meminta input tambahan. LANGSUNG berikan ringkasan dari teks transkrip di bawah ini!
+
+Ini adalah bagian ${i + 1} dari ${chunks.length} dari transkrip video YouTube yang panjang.
+
+# FORMAT OUTPUT (WAJIB)
+- Berikan ringkasan isi video secara kreatif, bebas, dan asik (boleh menggunakan paragraf naratif atau poin-poin penting yang mengalir).
+- DILARANG KERAS menyertakan atau menggunakan [timestamp] dalam bentuk apapun! Cukup ceritakan saja isi informasinya.
+- Gunakan bahasa Indonesia yang santai tapi tetap padat dan informatif.
+
+# VIDEO META DATA
+judul: ${data.judul || 'Tidak diketahui'},
+author: ${data.author || 'Tidak diketahui'}
+
+# TRANSCRIPT BAGIAN ${i + 1}
+${chunks[i]}
+`
+      console.log(`--- PROMPT YOUTUBE CHUNK ${i + 1}/${chunks.length} ---`)
+      console.log(chunkPrompt)
+
+      const response = await fetchAI([{ role: 'user', content: chunkPrompt }], false, {
+        signal,
+        isSmallTask: true
+      })
+      finalSummary += `${response.content}\n\n`
+
+      // Cooldown 12 detik jika bukan chunk terakhir (Menghindari TPM limit Groq)
+      if (i < chunks.length - 1) {
+        await new Promise((resolve) => setTimeout(resolve, 12000))
+      }
+    }
+
+    return finalSummary.trim()
+  } catch (error) {
+    console.error('Error in youtubeSummary:', error)
+    throw error
+  }
+}
+
+export const getBestMusicMatch = async (userInput, musicList, signal) => {
+  try {
+    const systemPrompt = `
+Kamu adalah asisten kurator musik. Tugasmu adalah memilih SATU lagu yang paling sesuai dengan niat pengguna dari daftar hasil pencarian YouTube Music.
+Gunakan logikamu:
+- Jika user meminta lagu secara spesifik (misal versi cover, live, atau karaoke), carilah judul yang mengandung unsur tersebut.
+- Jika user menyebutkan nama artis, prioritaskan artis tersebut.
+- Jika user hanya menyebutkan judul secara umum, pilih versi original atau official track yang paling populer/masuk akal (hindari live/cover/karaoke jika tidak diminta).
+
+# OUTPUT RULES
+Output HANYA boleh berupa valid JSON berisi ID lagu terpilih:
+\`\`\`json
+{ "selectedId": "id_lagu_pilihan" }
+\`\`\`
+`
+    const userPrompt = `
+Instruksi User: "${userInput}"
+
+Daftar Hasil Pencarian:
+${JSON.stringify(
+  musicList.map((m) => ({ id: m.id, title: m.title, artist: m.artist, duration: m.duration })),
+  null,
+  2
+)}
+`
+    const messages = [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: userPrompt }
+    ]
+
+    const schema = {
+      type: 'object',
+      properties: {
+        selectedId: { type: 'string' }
+      },
+      required: ['selectedId'],
+      additionalProperties: false
+    }
+
+    const response = await fetchAI(messages, false, {
+      signal,
+      isSmallTask: true,
+      jsonSchema: schema
+    })
+    const data = cleanAndParse(response.content)
+    return data
+  } catch (error) {
+    console.error('Error in getBestMusicMatch:', error)
+    return { selectedId: musicList[0]?.id }
+  }
+}

package/src/renderer/src/api/ai/utils.js

@@ -0,0 +1,359 @@
+import { getAllConfig } from '../db'
+import { stripMarkTags } from '@shared/parsers/mark-tag-parser.js'
+
+export const getCurrentTimeInfo = (dateObj = new Date()) => {
+  const options = {
+    weekday: 'long',
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    timeZoneName: 'short'
+  }
+  return dateObj.toLocaleDateString('id-ID', options)
+}
+
+let ttsAudioContext = null
+let currentAudioElement = null
+
+// Bersihkan tag kontrol (<mark ... />, legacy mood), tag <mic> / (Mikrofon), format markdown berlebih, dan tag teknis agar tidak terbaca oleh TTS
+export const cleanTextForTTS = (text) => {
+  if (!text || typeof text !== 'string') return ''
+  return stripMarkTags(text)
+    .replace(/(?:<mic>|\(Mikrofon\))/gi, '')
+    .replace(/```[\s\S]*?```/g, '') // Hapus blok kode
+    .replace(/`([^`]+)`/g, '$1') // Bersihkan inline code
+    .replace(/\*\*([^*]+)\*\*/g, '$1') // Bersihkan bold
+    .replace(/\*([^*]+)\*/g, '$1') // Bersihkan italic
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // Bersihkan link
+    .replace(/^[\s>#-]+/gm, '') // Bersihkan simbol quote/heading/list di awal baris
+    .trim()
+}
+
+/**
+ * Speech Queue Manager untuk memutar audio per kalimat secara berurutan,
+ * mulus, dan gapless dengan audio pre-buffering.
+ */
+class SpeechQueueManager {
+  constructor() {
+    this.queue = []
+    this.isPlaying = false
+    this.currentAudio = null
+    this.activeSessionId = 0
+  }
+
+  reset() {
+    this.activeSessionId++
+    // Bersihkan dan pause semua item di antrean yang mungkin sudah di-preload
+    for (const item of this.queue) {
+      if (item.audio) {
+        try {
+          item.audio.pause()
+          item.audio.currentTime = 0
+          item.audio.src = ''
+        } catch (_) {}
+      }
+    }
+    this.queue = []
+
+    if (this.currentAudio) {
+      try {
+        this.currentAudio.pause()
+        this.currentAudio.currentTime = 0
+        this.currentAudio.src = ''
+      } catch (_) {}
+      this.currentAudio = null
+    }
+    if (currentAudioElement) {
+      try {
+        currentAudioElement.pause()
+        currentAudioElement.currentTime = 0
+        currentAudioElement.src = ''
+      } catch (_) {}
+      currentAudioElement = null
+    }
+
+    this.isPlaying = false
+    window.isMarkSpeaking = false
+    window.dispatchEvent(new CustomEvent('mark-intensity', { detail: 0 }))
+  }
+
+  async preloadItem(item) {
+    if (item.audioPromise) return item.audioPromise
+    item.audioPromise = (async () => {
+      try {
+        const config = await getAllConfig()
+        const rate = config[0]?.ttsRate ?? 10
+        const pitch = config[0]?.ttsPitch ?? 55
+
+        const audioSrc = await window.api.textToSpeech(item.text, rate, pitch)
+        if (!audioSrc || item.sessionId !== this.activeSessionId) return null
+
+        const audio = new Audio(audioSrc)
+        audio.crossOrigin = 'anonymous'
+        audio.preload = 'auto'
+        // Picu buffer awal audio di latar belakang
+        audio.load()
+        item.audio = audio
+        return audio
+      } catch (err) {
+        console.warn('[SpeechQueue] Preload audio failed:', err)
+        return null
+      }
+    })()
+    return item.audioPromise
+  }
+
+  enqueue(text) {
+    const clean = cleanTextForTTS(text)
+    if (!clean) return
+    const sessionId = this.activeSessionId
+    const item = {
+      text: clean,
+      sessionId,
+      audio: null,
+      audioPromise: null
+    }
+
+    // Segera mulai preload audio di latar belakang
+    this.preloadItem(item)
+    this.queue.push(item)
+
+    if (!this.isPlaying) {
+      this.playNext()
+    }
+  }
+
+  async playNext() {
+    if (this.queue.length === 0) {
+      this.isPlaying = false
+      window.isMarkSpeaking = false
+      window.dispatchEvent(new CustomEvent('mark-intensity', { detail: 0 }))
+      return
+    }
+
+    const item = this.queue.shift()
+    if (item.sessionId !== this.activeSessionId) {
+      // Abaikan jika sesi bicara sudah di-reset
+      this.playNext()
+      return
+    }
+
+    // Pastikan item berikutnya di queue (jika ada) sedang di-preload
+    if (this.queue.length > 0) {
+      this.preloadItem(this.queue[0])
+    }
+
+    this.isPlaying = true
+    try {
+      // Dapatkan audio yang sudah di-preload atau tunggu sampai siap
+      let audio = item.audio
+      if (!audio && item.audioPromise) {
+        audio = await item.audioPromise
+      } else if (!audio) {
+        audio = await this.preloadItem(item)
+      }
+
+      if (!audio || item.sessionId !== this.activeSessionId) {
+        this.playNext()
+        return
+      }
+
+      this.currentAudio = audio
+      currentAudioElement = audio
+
+      let animationId = null
+      let analyser = null
+      let dataArray = null
+      let bufferLength = 0
+
+      try {
+        if (!ttsAudioContext || ttsAudioContext.state === 'closed') {
+          ttsAudioContext = new (window.AudioContext || window.webkitAudioContext)()
+        }
+        if (ttsAudioContext.state === 'suspended') {
+          await ttsAudioContext.resume()
+        }
+
+        const source = ttsAudioContext.createMediaElementSource(audio)
+        analyser = ttsAudioContext.createAnalyser()
+        analyser.fftSize = 256
+        analyser.smoothingTimeConstant = 0.4
+        source.connect(analyser)
+        analyser.connect(ttsAudioContext.destination)
+
+        bufferLength = analyser.frequencyBinCount
+        dataArray = new Uint8Array(bufferLength)
+      } catch (_) {}
+
+      const updateIntensity = () => {
+        if (!window.isMarkSpeaking || !analyser) return
+        analyser.getByteFrequencyData(dataArray)
+        let sum = 0
+        for (let i = 0; i < bufferLength; i++) {
+          sum += dataArray[i]
+        }
+        const avg = sum / bufferLength
+        const normalized = Math.min(1, Math.max(0, (avg - 8) / 55))
+        window.dispatchEvent(new CustomEvent('mark-intensity', { detail: normalized }))
+        animationId = requestAnimationFrame(updateIntensity)
+      }
+
+      const cleanupAndNext = () => {
+        if (animationId) cancelAnimationFrame(animationId)
+        if (this.currentAudio === audio) {
+          this.currentAudio = null
+        }
+        this.playNext()
+      }
+
+      audio.onended = cleanupAndNext
+      audio.onerror = cleanupAndNext
+
+      window.isMarkSpeaking = true
+      await audio.play()
+      if (analyser) updateIntensity()
+    } catch (err) {
+      console.warn('[SpeechQueue] Error playing segment:', err)
+      this.playNext()
+    }
+  }
+}
+
+export const speechQueue = new SpeechQueueManager()
+
+export const playVoice = async (text, onStart, onEnd) => {
+  try {
+    if (!text || typeof text !== 'string') {
+      if (onStart) onStart()
+      if (onEnd) onEnd()
+      return
+    }
+
+    speechQueue.reset()
+
+    // Hentikan pemutaran sebelumnya jika sedang ada suara aktif
+    if (currentAudioElement) {
+      try {
+        currentAudioElement.pause()
+        currentAudioElement.currentTime = 0
+      } catch (_) {}
+      currentAudioElement = null
+    }
+
+    const cleanText = cleanTextForTTS(text)
+    if (!cleanText) {
+      if (onStart) onStart()
+      if (onEnd) onEnd()
+      return
+    }
+
+    const config = await getAllConfig()
+    const rate = config[0]?.ttsRate ?? 10
+    const pitch = config[0]?.ttsPitch ?? 55
+
+    // 1. Minta stream URL audio ke backend
+    const audioSrc = await window.api.textToSpeech(cleanText, rate, pitch)
+
+    if (audioSrc) {
+      // 2. Bikin object Audio baru dari stream URL
+      const audio = new Audio(audioSrc)
+      audio.crossOrigin = 'anonymous'
+      currentAudioElement = audio
+
+      let animationId = null
+      let analyser = null
+      let dataArray = null
+      let bufferLength = 0
+
+      // Setup Web Audio API for Intensity Extraction
+      try {
+        if (!ttsAudioContext || ttsAudioContext.state === 'closed') {
+          ttsAudioContext = new (window.AudioContext || window.webkitAudioContext)()
+        }
+        if (ttsAudioContext.state === 'suspended') {
+          await ttsAudioContext.resume()
+        }
+
+        const source = ttsAudioContext.createMediaElementSource(audio)
+        analyser = ttsAudioContext.createAnalyser()
+        analyser.fftSize = 256
+        analyser.smoothingTimeConstant = 0.4
+        source.connect(analyser)
+        analyser.connect(ttsAudioContext.destination)
+
+        bufferLength = analyser.frequencyBinCount
+        dataArray = new Uint8Array(bufferLength)
+      } catch (_) {
+        // Fallback jika createMediaElementSource terhalang: audio tetap play secara mandiri
+      }
+
+      const updateIntensity = () => {
+        if (!window.isMarkSpeaking || !analyser) return
+        analyser.getByteFrequencyData(dataArray)
+        let sum = 0
+        for (let i = 0; i < bufferLength; i++) {
+          sum += dataArray[i]
+        }
+        const avg = sum / bufferLength
+        // Normalisasi 0 - 255 menjadi 0.0 - 1.0 dengan respons dinamis
+        const normalized = Math.min(1, Math.max(0, (avg - 8) / 55))
+        window.dispatchEvent(new CustomEvent('mark-intensity', { detail: normalized }))
+        animationId = requestAnimationFrame(updateIntensity)
+      }
+
+      audio.onended = () => {
+        window.isMarkSpeaking = false
+        if (currentAudioElement === audio) {
+          currentAudioElement = null
+        }
+        window.dispatchEvent(new CustomEvent('mark-intensity', { detail: 0 }))
+        if (animationId) cancelAnimationFrame(animationId)
+        if (onEnd) onEnd()
+      }
+
+      audio.onerror = (e) => {
+        console.warn('[playVoice] Audio playback warning:', e)
+        window.isMarkSpeaking = false
+        if (currentAudioElement === audio) {
+          currentAudioElement = null
+        }
+        window.dispatchEvent(new CustomEvent('mark-intensity', { detail: 0 }))
+        if (animationId) cancelAnimationFrame(animationId)
+        if (onEnd) onEnd()
+      }
+
+      // 3. Mainkan audio seketika
+      window.isMarkSpeaking = true
+      await audio.play()
+      if (analyser) updateIntensity()
+      if (onStart) onStart()
+    } else {
+      if (onStart) onStart()
+      if (onEnd) onEnd()
+    }
+  } catch (error) {
+    console.error('Gagal memutar suara:', error)
+    if (window.api && window.api.showNotification) {
+      window.api.showNotification('Error TTS', String(error.message || error))
+    }
+    window.isMarkSpeaking = false
+    window.dispatchEvent(new CustomEvent('mark-intensity', { detail: 0 }))
+    if (onStart) onStart()
+    if (onEnd) onEnd()
+  }
+}
+
+// ==========================================
+// TELEGRAM UTILS
+// ==========================================
+export const formatForTelegram = (text) => {
+  if (!text) return ''
+  return text.trim()
+}
+
+// ==========================================
+// PLANNING (AGENTIC) FUNCTIONS
+// ==========================================