Release 0.1.41 [auto-version-bump]

README.md

@@ -20,6 +20,8 @@ When a character or NPC is created, its saved voice identity is masculine, femin
 
 System voice commands require the prefix `röstkommando`: `upprepa`, `avbryt`, `hjälp`, `alternativ`, or `paus`. Without the prefix, the same words remain ordinary dialogue. Speech recognition and synthesis are browser-dependent; release acceptance must record which real iPhone/Safari/VoiceOver and Android/Chrome/TalkBack combinations were actually checked.
 
+On iPhone and iPad, Safari may require a direct tap or key press before it permits speech output. The frontend primes speech silently on the first player gesture and then reads game replies automatically. The status reports speech as in progress only after the browser's `onstart` event. Voice settings include **Testa ljudet**; if a game reply does not start, a **Läs senaste repliken** button appears in the dialogue. When Safari reports speech started but the player hears nothing, the status suggests checking device volume and audio output. The introduction is only marked as heard after the browser reports that speech actually started. The speech queue avoids an immediate `cancel()` followed by `speak()`, which older WebKit releases can drop.
+
 The browser and API stay on the same public origin, `https://ai-spel.k3s.k0.nu`. The ingress routes `/` to this frontend service and routes `/api`, `/version`, and `/health` to the Rust service. That keeps the current server-side session cookie same-origin and avoids browser CORS configuration.
 
 ## Release flow

VERSION

@@ -1 +1 @@
-0.1.33
+0.1.41

deploy/helm/ai-spel-frontend/Chart.yaml

@@ -2,5 +2,5 @@ apiVersion: v2
 name: ai-spel-frontend
 description: Static web frontend for the Swedish life simulator
 type: application
-version: 0.1.33
-appVersion: "0.1.33"
+version: 0.1.41
+appVersion: "0.1.41"

index.html

@@ -37,7 +37,8 @@
     <section id="auth" aria-labelledby="auth-heading">
       <h1 id="auth-heading">Svensk livssimulator</h1>
       <p id="auth-intro">Välkommen till en svensk, dialogbaserad livssimulator utan bilder. Världen beskrivs med ljud, dofter, temperatur, beröring och riktning. Skapa konto med ett användarnamn och ett lösenord på minst tolv tecken. Berätta sedan fritt om en vuxen person. Du får redigera och godkänna personens biografi och startplats. Spela genom att skriva eller tala vad du gör och frågar. Personer du möter kan minnas tidigare samtal. Spelets repliker läses automatiskt upp på svenska och finns kvar som text. Har du redan konto väljer du Logga in.</p>
-      <button type="button" id="auth-repeat-intro">Läs introduktionen igen</button>
+      <button type="button" id="auth-repeat-intro">Läs introduktionen</button>
+      <p id="auth-voice-status" role="status" aria-live="polite">På iPhone och iPad kan du behöva trycka på Läs introduktionen igen en gång för att aktivera uppläsningen.</p>
       <p id="auth-status" role="status" aria-live="polite" hidden></p>
       <form id="auth-form">
         <label>Användarnamn <input name="username" required minlength="3" maxlength="40" autocomplete="username"></label>
@@ -71,7 +72,7 @@
     </section>
   </main>
   <footer id="version-footer">Frontend <span id="frontend-version">__FRONTEND_VERSION__</span> · API <span id="api-version">hämtar version…</span></footer>
-  <script src="/voice.js"></script>
+  <script src="/voice.js?v=__FRONTEND_VERSION__"></script>
   <script>
     const auth = document.querySelector('#auth');
     const play = document.querySelector('#play');
@@ -88,13 +89,18 @@
     let pendingDialogue = null;
     let latestAssistantText = '';
     let latestAssistantVoice = {role: 'narrator', voiceIdentity: 'neutral'};
+    let speechRecoveryElement = null;
     const voiceSettingsKey = 'ai-spel.voice-settings.v2';
     let voiceSettings = window.GameVoice.loadSettings(localStorage, voiceSettingsKey, 'ai-spel.voice-settings.v1');
     let voiceController;
+    let speechActivatedByGesture = false;
     let audioContext;
     let voiceDisclosureAcknowledged = false;
     let adminOffset = 0;
     const adminPageSize = 50;
+    let presenceTimer = null;
+    let playerMessagesPrimed = false;
+    const seenPlayerMessageIds = new Set();
 
     async function request(path, options = {}) {
       const response = await fetch(path, {credentials: 'same-origin', ...options});
@@ -112,11 +118,29 @@
         latestAssistantText = content;
         latestAssistantVoice = options.voice || {role: 'narrator', voiceIdentity: 'neutral'};
         if (options.speak !== false && location.pathname !== '/admin') {
-          voiceController?.speak(content, latestAssistantVoice);
+          voiceController?.speak(content, {...latestAssistantVoice, onStart: clearSpeechRecovery});
         }
       }
       return line;
     }
+    function biographyContextText(context) {
+      if (!context || typeof context !== 'object') return '';
+      const details = [];
+      if (typeof context.current_situation === 'string' && context.current_situation.trim()) {
+        details.push(`Nuvarande situation: ${context.current_situation.trim()}.`);
+      }
+      for (const [key, label] of [
+        ['skills', 'Färdigheter'],
+        ['possessions', 'Ägodelar som nämnts'],
+        ['obligations', 'Åtaganden'],
+        ['past_events', 'Tidigare händelser'],
+        ['known_people', 'Kända personer'],
+      ]) {
+        const values = context[key];
+        if (Array.isArray(values) && values.length) details.push(`${label}: ${values.join(', ')}.`);
+      }
+      return details.length ? `\n\nStartuppgifter att granska: ${details.join(' ')}` : '';
+    }
     function explainDialogueError(error) {
       const code = String(error?.message || '');
       const known = {
@@ -128,7 +152,38 @@
         ? 'Jag kunde inte behandla det just nu. Försök igen om en liten stund.'
         : code || 'Ett tillfälligt fel uppstod. Försök igen om en liten stund.');
     }
-    function setVoiceStatus(message = '') { document.querySelector('#voice-status').textContent = message; }
+    function setVoiceStatus(message = '') {
+      document.querySelector('#voice-status').textContent = message;
+      const authVoiceStatus = document.querySelector('#auth-voice-status');
+      if (authVoiceStatus && !auth.hidden && message) authVoiceStatus.textContent = message;
+    }
+    function clearSpeechRecovery() {
+      speechRecoveryElement?.remove();
+      speechRecoveryElement = null;
+      const status = document.querySelector('#voice-status');
+      if (status?.textContent.startsWith('Uppläsningen startade inte')) setVoiceStatus('Läser upp dialog.');
+    }
+    function showSpeechRecovery(message) {
+      clearSpeechRecovery();
+      const item = document.createElement('li');
+      item.dataset.role = 'voice-controls';
+      item.setAttribute('aria-label', 'Uppläsning kunde inte starta');
+      const explanation = document.createElement('p');
+      explanation.textContent = message;
+      const retry = document.createElement('button');
+      retry.type = 'button';
+      retry.textContent = 'Läs senaste repliken';
+      retry.addEventListener('click', () => {
+        voiceController.activateFromUserGesture();
+        if (voiceController.speak(latestAssistantText, {...latestAssistantVoice, onStart: clearSpeechRecovery})) {
+          clearSpeechRecovery();
+        }
+      });
+      item.append(explanation, retry);
+      transcript.append(item);
+      item.scrollIntoView({block: 'end'});
+      speechRecoveryElement = item;
+    }
     function refreshMicrophone() {
       const button = document.querySelector('#microphone');
       if (button) button.disabled = play.hidden || messageField.disabled || submitBusy;
@@ -164,12 +219,20 @@
         microphone.textContent = listening ? 'Avsluta mikrofon' : 'Starta mikrofon';
         refreshMicrophone();
         if (message) setVoiceStatus(message);
+        else if (state === 'IDLE') setVoiceStatus('');
+        if (/Läs senaste repliken/.test(message)) showSpeechRecovery(message);
         playVoiceSignal(state === 'IDLE' && /Mikrofonen är avstängd/.test(message) ? 'STOPPED' : state);
       },
       onTranscript(text) {
         return submitMessage(text, 'voice');
       },
     });
+    function primeSpeechFromGesture(event) {
+      if (speechActivatedByGesture || !event.isTrusted) return;
+      speechActivatedByGesture = voiceController.activateFromUserGesture();
+    }
+    document.addEventListener('pointerdown', primeSpeechFromGesture, true);
+    document.addEventListener('keydown', primeSpeechFromGesture, true);
     persistVoiceSettings();
 
     function addVoiceButton(parent, label, handler) {
@@ -205,8 +268,16 @@
       signalLabel.append(signals, document.createTextNode(' Ljudsignal vid röstinmatning')); fieldset.append(signalLabel);
       item.append(fieldset);
       const speakLatest = () => {
-        if (!voiceController.speak(latestAssistantText, latestAssistantVoice)) setVoiceStatus('Talsyntes stöds inte i den här webbläsaren. Dialogen finns kvar som text.');
+        voiceController.activateFromUserGesture();
+        if (!voiceController.speak(latestAssistantText, {...latestAssistantVoice, onStart: clearSpeechRecovery})) setVoiceStatus('Talsyntes stöds inte i den här webbläsaren. Dialogen finns kvar som text.');
       };
+      const testSpeech = () => {
+        voiceController.activateFromUserGesture();
+        if (!voiceController.speak('Det här är ett test av uppläsningen.', {role: 'narrator', voiceIdentity: 'neutral', onStart: clearSpeechRecovery})) {
+          setVoiceStatus('Talsyntes stöds inte i den här webbläsaren. Dialogen finns kvar som text.');
+        }
+      };
+      addVoiceButton(item, 'Testa ljudet', testSpeech);
       addVoiceButton(item, 'Läs senaste repliken', speakLatest);
       addVoiceButton(item, 'Upprepa', speakLatest);
       addVoiceButton(item, 'Avbryt uppläsning', () => voiceController.cancelSpeech());
@@ -285,29 +356,44 @@
       auth.hidden = true;
       adminView.hidden = true;
       play.hidden = false;
-      document.querySelector('#version-footer').hidden = true;
       refreshMicrophone();
       messageField.focus();
     }
     function showAdmin() {
+      if (presenceTimer) clearInterval(presenceTimer);
+      presenceTimer = null;
       voiceController.stopAll();
       auth.hidden = true;
       play.hidden = true;
       adminView.hidden = false;
       document.querySelector('#version-footer').hidden = true;
     }
-    const introductionKey = 'ai-spel.introduction-heard.v1';
+    const introductionKey = 'ai-spel.introduction-heard.v2';
     function playFirstVisitIntroduction() {
       let alreadyHeard = false;
       try { alreadyHeard = localStorage.getItem(introductionKey) === 'true'; } catch (_) { /* Keep the intro available for this visit. */ }
       if (alreadyHeard) return;
-      const introduction = document.querySelector('#auth-intro').textContent;
-      if (voiceController.speak(introduction, {role: 'narrator', voiceIdentity: 'neutral'})) {
-        try { localStorage.setItem(introductionKey, 'true'); } catch (_) { /* The page text remains available. */ }
+      const isAppleMobile = /iPad|iPhone|iPod/i.test(navigator.userAgent)
+        || (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1);
+      if (isAppleMobile) {
+        document.querySelector('#auth-repeat-intro').textContent = 'Läs introduktionen';
+        return;
       }
+      const introduction = document.querySelector('#auth-intro').textContent;
+      voiceController.speak(introduction, {
+        role: 'narrator', voiceIdentity: 'neutral',
+        onStart() { try { localStorage.setItem(introductionKey, 'true'); } catch (_) { /* The page text remains available. */ } },
+      });
     }
     document.querySelector('#auth-repeat-intro').addEventListener('click', () => {
-      if (location.pathname !== '/admin') voiceController.speak(document.querySelector('#auth-intro').textContent, {role: 'narrator', voiceIdentity: 'neutral'});
+      if (location.pathname !== '/admin') {
+        voiceController.activateFromUserGesture();
+        const introduction = document.querySelector('#auth-intro').textContent;
+        voiceController.speak(introduction, {
+          role: 'narrator', voiceIdentity: 'neutral',
+          onStart() { try { localStorage.setItem(introductionKey, 'true'); } catch (_) { /* The page text remains available. */ } },
+        });
+      }
     });
     function explainAuthError(error, intent) {
       if (intent === 'register' && error?.message === 'username_unavailable') return 'Det användarnamnet används redan. Välj ett annat och försök igen.';
@@ -361,6 +447,7 @@
       const trace = await request(`/api/admin/players/${encodeURIComponent(accountId)}/trace?limit=200`);
       const entries = [
         ...trace.events.map(event => ({kind: 'Världshändelse', at: event.recorded_at, order: event.commit_sequence, data: event})),
+        ...trace.player_messages.map(message => ({kind: 'Privat spelarmeddelande', at: message.recorded_at, order: message.sequence, data: message})),
         ...trace.ai_interactions.map(interaction => ({kind: `AI ${interaction.prompt_id} · ${interaction.outcome}`, at: interaction.requested_at, order: interaction.correlation_id, data: interaction}))
       ].sort((a, b) => String(a.at).localeCompare(String(b.at)));
       adminElement('h2', 'Kronologiskt spelarspår');
@@ -501,8 +588,22 @@
       }
       await loadSavedDialogue();
       setStage('game');
+      startPlayerPresence();
+      announcePlayerChatHelp();
+    }
+    function announcePlayerChatHelp() {
+      const key = 'ai-spel.player-chat-help.v1';
+      try {
+        if (localStorage.getItem(key) === 'true') return;
+        localStorage.setItem(key, 'true');
+      } catch (_) { /* The help remains available through dialogue questions. */ }
+      appendLine('assistant', 'Du kan fråga vilka andra spelare som är här, säga “Säg till Robin: hej” för att skriva direkt till en spelare eller be mig visa meddelanden från spelare.');
     }
     async function handleLogout() {
+      if (presenceTimer) clearInterval(presenceTimer);
+      presenceTimer = null;
+      playerMessagesPrimed = false;
+      seenPlayerMessageIds.clear();
       await request('/api/logout', {method: 'POST'});
       if (location.pathname !== '/admin') appendLine('assistant', 'Du har loggat ut. Logga in igen för att fortsätta spela.');
       characterDraft = null;
@@ -542,7 +643,7 @@
           body: JSON.stringify({input: message, current_draft: characterDraft}),
         });
         characterDraft = proposal.draft;
-        appendLine('assistant', `${proposal.message}\n\nFörslag: ${characterDraft.name}, ${characterDraft.age} år.\n${characterDraft.biography}\n\nSkriv ändringar eller “godkänn”.`);
+        appendLine('assistant', `${proposal.message}\n\nFörslag: ${characterDraft.name}, ${characterDraft.age} år.\n${characterDraft.biography}${biographyContextText(characterDraft.life_context)}\n\nSkriv ändringar eller “godkänn”.`);
       } catch (error) {
         appendLine('assistant', `Jag kunde inte ta fram ett biografiförslag: ${error.message}. Försök igen när tjänsten svarar.`);
       }
@@ -569,6 +670,7 @@
         else await proposeWorld(message);
         return;
       }
+      if (await handlePlayerMessageCommand(message)) return;
       const idempotencyKey = pendingDialogue?.message === message
         ? pendingDialogue.idempotencyKey
         : crypto.randomUUID();
@@ -649,6 +751,87 @@
         if (!play.hidden && !messageField.disabled) messageField.focus();
       }
     }
+    async function handlePlayerMessageCommand(message) {
+      const listPlayers = /^(?:vilka (?:andra )?spelare är här|finns det andra spelare här)\??$/i.test(message.trim());
+      const sendMatch = /^(?:säg|skriv|skicka) till ([^:]{1,80}):\s*(.{1,4000})$/is.exec(message.trim());
+      const readMessages = /^(?:visa|läs upp) (?:de senaste )?meddelanden från spelare\.?$/i.test(message.trim());
+      if (!listPlayers && !sendMatch && !readMessages) return false;
+      appendLine('user', message);
+      try {
+        if (listPlayers) {
+          const players = await request('/api/players/nearby');
+          appendLine('assistant', players.length
+            ? `Här finns ${players.map(player => player.name).join(', ')} att prata med.`
+            : 'Just nu finns inga andra inloggade spelare på platsen.');
+          return true;
+        }
+        if (readMessages) {
+          const messages = await request('/api/player/messages');
+          const recent = messages.slice(-10);
+          if (recent.length === 0) appendLine('assistant', 'Du har inga sparade meddelanden från andra spelare.');
+          else for (const entry of recent) {
+            seenPlayerMessageIds.add(entry.id);
+            const isIncoming = entry.direction === 'incoming';
+            appendLine(isIncoming ? 'assistant' : 'user', entry.message, isIncoming
+              ? {speaker: entry.sender_name, voice: {characterId: entry.sender_character_id, voiceIdentity: entry.sender_voice_identity}}
+              : {speaker: 'Du', speak: false});
+          }
+          return true;
+        }
+        const players = await request('/api/players/nearby');
+        const targetName = sendMatch[1].trim();
+        const matches = players.filter(player => player.name.localeCompare(targetName, 'sv', {sensitivity: 'base'}) === 0);
+        if (matches.length === 0) {
+          appendLine('assistant', `Jag hittar ingen inloggad spelare som heter ${targetName} på platsen. Fråga vilka andra spelare som är här.`);
+          return true;
+        }
+        if (matches.length > 1) {
+          appendLine('assistant', `Flera spelare heter ${targetName}. Säg vilket namn de använder i spelet.`);
+          return true;
+        }
+        const key = pendingPlayerMessage?.text === sendMatch[2] && pendingPlayerMessage?.target === matches[0].character_id
+          ? pendingPlayerMessage.key
+          : crypto.randomUUID();
+        pendingPlayerMessage = {text: sendMatch[2], target: matches[0].character_id, key};
+        const result = await request(`/api/players/${encodeURIComponent(matches[0].character_id)}/messages`, {
+          method: 'POST', headers: {'content-type': 'application/json'},
+          body: JSON.stringify({message: sendMatch[2], idempotency_key: key}),
+        });
+        pendingPlayerMessage = null;
+        appendLine('assistant', `Ditt meddelande skickades till ${matches[0].name}.`);
+        return Boolean(result.message_id);
+      } catch (error) {
+        messageField.value = message;
+        appendLine('assistant', `Spelarmeddelandet kunde inte hanteras: ${explainDialogueError(error)}`);
+        return true;
+      }
+    }
+    let pendingPlayerMessage = null;
+    async function startPlayerPresence() {
+      if (presenceTimer) clearInterval(presenceTimer);
+      const refresh = async (announceNewMessages) => {
+        if (play.hidden || stage !== 'game') return;
+        try {
+          await request('/api/presence/heartbeat', {method: 'POST'});
+          const messages = await request('/api/player/messages');
+          for (const entry of messages) {
+            if (seenPlayerMessageIds.has(entry.id)) continue;
+            if (announceNewMessages && entry.direction === 'incoming'
+                && (submitBusy || ['LISTENING', 'PROCESSING', 'SPEAKING'].includes(voiceController.getState()))) continue;
+            seenPlayerMessageIds.add(entry.id);
+            if (announceNewMessages && entry.direction === 'incoming') {
+              appendLine('assistant', entry.message, {
+                speaker: entry.sender_name,
+                voice: {characterId: entry.sender_character_id, voiceIdentity: entry.sender_voice_identity},
+              });
+            }
+          }
+          playerMessagesPrimed = true;
+        } catch (_) { /* Presence is a hint; the text game remains usable if it is unavailable. */ }
+      };
+      await refresh(playerMessagesPrimed);
+      presenceTimer = setInterval(() => refresh(true), 30_000);
+    }
     document.querySelector('#message-form').addEventListener('submit', async (event) => {
       event.preventDefault();
       await submitMessage(messageField.value);

nginx/default.conf

@@ -10,7 +10,9 @@ server {
     }
 
     location / {
-        add_header Cache-Control "no-cache" always;
+        add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0" always;
+        add_header Pragma "no-cache" always;
+        add_header Expires "0" always;
         try_files $uri $uri/ /index.html;
     }
 }

scripts/check-frontend.sh

@@ -4,6 +4,8 @@ set -euo pipefail
 test -s index.html
 grep -q '<html lang="sv">' index.html
 grep -q 'id="frontend-version">__FRONTEND_VERSION__' index.html
+grep -q '<script src="/voice.js?v=__FRONTEND_VERSION__"></script>' index.html
+grep -q 'no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0' nginx/default.conf
 grep -q "request('/version')" index.html
 grep -Fq "credentials: 'same-origin'" index.html
 grep -q 'id="dialogue" aria-label="Dialoghistorik" role="log" aria-live="polite"' index.html
@@ -12,14 +14,22 @@ grep -q 'id="auth-intro"' index.html
 grep -q 'Skapa konto med ett användarnamn och ett lösenord på minst tolv tecken' index.html
 grep -q 'id="auth-repeat-intro"' index.html
 grep -q 'function playFirstVisitIntroduction' index.html
+grep -q 'id="auth-voice-status" role="status" aria-live="polite"' index.html
+grep -q 'activateFromUserGesture' index.html
+grep -q 'function showSpeechRecovery' index.html
+grep -q "retry.textContent = 'Läs senaste repliken'" index.html
 grep -q "location.pathname !== '/admin'" index.html
 grep -q "if (options.speak !== false && location.pathname !== '/admin')" index.html
 grep -q 'id="microphone" aria-pressed="false"' index.html
 grep -q 'id="voice-status" role="status" aria-live="polite"' index.html
 grep -q "window.GameVoice.createVoiceController" index.html
+grep -q "addVoiceButton(item, 'Testa ljudet'" index.html
 grep -q 'Jag förstår – starta mikrofonen' index.html
 grep -q 'supportsRecognition' voice.js
 grep -q 'characterVoiceProfile' voice.js
+grep -q 'utterance.volume = 1' voice.js
+grep -q 'Uppläsningen har startat' voice.js
+grep -q 'WebKit versions before Safari 27' voice.js
 grep -q "voiceIdentity: speakingNpc.voice_identity" index.html
 grep -q "role: 'narrator', voiceIdentity: 'neutral'" index.html
 grep -q 'COPY voice.js /usr/share/nginx/html/voice.js' Dockerfile
@@ -30,6 +40,10 @@ grep -q "event.key === 'Enter' && !event.shiftKey" index.html
 grep -q "request('/api/character/draft'" index.html
 grep -q "request('/api/world/draft'" index.html
 grep -q "request('/api/dialogue'" index.html
+grep -q "request('/api/presence/heartbeat'" index.html
+grep -q "request('/api/players/nearby'" index.html
+grep -q "request('/api/player/messages'" index.html
+grep -q "Säg till Robin" index.html
 grep -q "result.intent === 'move' || result.intent === 'meet'" index.html
 grep -q 'dialogue_temporarily_unavailable:' index.html
 grep -q 'id="admin-view"' index.html

tests/voice.test.cjs

@@ -14,6 +14,7 @@ function makeHarness({supported = true, tts = true, onTranscript = () => Promise
   const utterances = [];
   const states = [];
   const timers = new Map();
+  const timerDelays = new Map();
   let timerId = 0;
   class Recognition {
     constructor() { recognitions.push(this); }
@@ -31,8 +32,8 @@ function makeHarness({supported = true, tts = true, onTranscript = () => Promise
     cancel() { this.cancelled += 1; },
   } : undefined;
   const window = {
-    setTimeout(callback) { const id = ++timerId; timers.set(id, callback); return id; },
-    clearTimeout(id) { timers.delete(id); },
+    setTimeout(callback, delay = 0) { const id = ++timerId; timers.set(id, callback); timerDelays.set(id, delay); return id; },
+    clearTimeout(id) { timers.delete(id); timerDelays.delete(id); },
     speechSynthesis: synthesis,
     SpeechSynthesisUtterance: tts ? Utterance : undefined,
     SpeechRecognition: supported ? Recognition : undefined,
@@ -43,7 +44,14 @@ function makeHarness({supported = true, tts = true, onTranscript = () => Promise
     onState: (state, message) => states.push({state, message}),
     onTranscript,
   });
-  return {controller, recognitions, utterances, synthesis, states, timers};
+  return {
+    controller, recognitions, utterances, synthesis, states, timers,
+    runTimer(delay) {
+      const match = [...timerDelays.entries()].find(([, value]) => value === delay);
+      if (!match) throw new Error(`No timer found with delay ${delay}`);
+      timers.get(match[0])();
+    },
+  };
 }
 
 test('recognition is single-shot Swedish and sends only final transcript once', async () => {
@@ -122,6 +130,62 @@ test('TTS selects Swedish fallback, applies rate, and cancellation invalidates c
   assert.equal(h.controller.getState(), 'IDLE');
 });
 
+test('speech is reported as in progress only after the native onstart event', () => {
+  const h = makeHarness();
+  h.controller.speak('Hej.');
+  assert.equal(h.controller.getState(), 'QUEUED');
+  assert.match(h.states.at(-1).message, /Startar uppläsningen/);
+  h.utterances[0].onstart();
+  assert.equal(h.controller.getState(), 'SPEAKING');
+  assert.match(h.states.at(-1).message, /Uppläsningen har startat/);
+  assert.match(h.states.at(-1).message, /iPadens volym/);
+});
+
+test('iOS user gesture primes speech silently and idle speech is not cancelled before speak', () => {
+  const h = makeHarness();
+  assert.equal(h.controller.activateFromUserGesture(), true);
+  assert.equal(h.synthesis.spoken[0].text, ' ');
+  assert.equal(h.synthesis.spoken[0].volume, 0);
+  const cancelledBeforeReply = h.synthesis.cancelled;
+  assert.equal(h.controller.speak('Ett svar efter nätverksanropet'), true);
+  assert.equal(h.synthesis.spoken.at(-1).text, 'Ett svar efter nätverksanropet');
+  assert.equal(h.synthesis.cancelled, cancelledBeforeReply);
+});
+
+test('replacing active speech waits one event-loop turn after WebKit cancel', () => {
+  const h = makeHarness();
+  h.controller.speak('Första repliken');
+  const cancelledBeforeReplace = h.synthesis.cancelled;
+  h.controller.speak('Nästa replik');
+  assert.equal(h.synthesis.cancelled, cancelledBeforeReplace + 1);
+  assert.notEqual(h.synthesis.spoken.at(-1).text, 'Nästa replik');
+  h.runTimer(100);
+  assert.equal(h.synthesis.spoken.at(-1).text, 'Nästa replik');
+});
+
+test('speech start timeout tells the player how to recover when mobile playback is blocked', () => {
+  const h = makeHarness();
+  h.controller.speak('En replik');
+  const cancelledBeforeTimeout = h.synthesis.cancelled;
+  h.runTimer(4000);
+  assert.match(h.states.at(-1).message, /Tryck på Läs senaste repliken/);
+  assert.equal(h.synthesis.cancelled, cancelledBeforeTimeout + 1);
+  const cancelledBeforeRetry = h.synthesis.cancelled;
+  h.controller.speak('Manuell återläsning');
+  assert.equal(h.synthesis.spoken.at(-1).text, 'Manuell återläsning');
+  assert.equal(h.synthesis.cancelled, cancelledBeforeRetry);
+});
+
+test('iOS not-allowed speech error offers an immediate gesture-based retry', () => {
+  const h = makeHarness();
+  h.controller.speak('En replik');
+  h.utterances[0].onerror({error: 'not-allowed'});
+  assert.match(h.states.at(-1).message, /Safari blockerade uppläsningen/);
+  assert.match(h.states.at(-1).message, /Läs senaste repliken/);
+  assert.equal(h.controller.speak('Försök igen'), true);
+  assert.equal(h.synthesis.spoken.at(-1).text, 'Försök igen');
+});
+
 test('character voice identity gives stable distinct masculine, feminine, and neutral timbres', () => {
   const profile = GameVoice.characterVoiceProfile;
   const masculine = profile('masculine', 'character-1');
@@ -138,6 +202,7 @@ test('narrator uses neutral pitch while character replies use their saved voice
   h.controller.update({mode: 'game-voice'});
   h.controller.speak('Berättarröst', {role: 'narrator', voiceIdentity: 'feminine', characterId: 'narrator'});
   h.controller.speak('NPC-replik', {voiceIdentity: 'masculine', characterId: 'npc-1'});
+  h.runTimer(100);
   assert.equal(h.utterances[0].pitch, 1);
   assert.ok(h.utterances[1].pitch < 1);
 });
@@ -148,6 +213,8 @@ test('TTS and microphone are mutually exclusive', () => {
   h.controller.startListening();
   h.controller.speak('Svar');
   assert.equal(h.recognitions[0].aborted, true);
+  assert.equal(h.controller.getState(), 'QUEUED');
+  h.utterances[0].onstart();
   assert.equal(h.controller.getState(), 'SPEAKING');
 });
 

voice.js

@@ -78,7 +78,10 @@
     let generation = 0;
     let recognition = null;
     let speechTimer = null;
+    let speechStartTimer = null;
     let listeningTimer = null;
+    let currentUtterance = null;
+    let speechPrimed = false;
 
     function setState(next, message = '') {
       state = next;
@@ -88,11 +91,34 @@
     function cancelSpeech() {
       generation += 1;
       if (speechTimer !== null) win.clearTimeout(speechTimer);
+      if (speechStartTimer !== null) win.clearTimeout(speechStartTimer);
       speechTimer = null;
+      speechStartTimer = null;
+      const wasQueued = currentUtterance !== null;
+      currentUtterance = null;
+      // WebKit versions before Safari 27 can discard a speak() queued in the
+      // same turn as cancel(). Do not clear an already-empty native queue.
+      if (wasQueued) {
         try { win.speechSynthesis?.cancel(); } catch (_) { /* Best effort. */ }
+      }
       if (!recognition) setState('IDLE');
     }
 
+    function activateFromUserGesture() {
+      if (!win.speechSynthesis || !win.SpeechSynthesisUtterance) return false;
+      if (speechPrimed) return true;
+      // iOS Safari requires speech output to be initiated by a user gesture.
+      // Prime its speech channel silently on the first trusted tap/key press so
+      // later game replies can be spoken after the API response arrives.
+      try {
+        const primer = new win.SpeechSynthesisUtterance(' ');
+        primer.volume = 0;
+        win.speechSynthesis.speak(primer);
+        speechPrimed = true;
+        return true;
+      } catch (_) { return false; }
+    }
+
     function finishRecognition(token, message = '') {
       if (token !== generation) return;
       if (listeningTimer !== null) win.clearTimeout(listeningTimer);
@@ -179,14 +205,19 @@
     }
 
     function speak(text, voiceOptions = {}) {
-      if (!text || !win.speechSynthesis || !win.SpeechSynthesisUtterance) return false;
+      if (!text || !win.speechSynthesis || !win.SpeechSynthesisUtterance) {
+        setState('IDLE', 'Talsyntes stöds inte i den här webbläsaren. Dialogen finns kvar som text.');
+        return false;
+      }
       stopListening();
-      cancelSpeech();
-      const token = generation;
+      const hadQueuedUtterance = currentUtterance !== null;
+      if (hadQueuedUtterance) cancelSpeech();
+      const token = ++generation;
       let utterance;
       try { utterance = new win.SpeechSynthesisUtterance(text); }
       catch (_) { setState('IDLE', 'Talsyntesen kunde inte startas. Dialogen finns kvar som text.'); return false; }
       utterance.lang = settings.language || 'sv-SE';
+      utterance.volume = 1;
       const profile = voiceOptions.characterId ? settings.speakerProfiles?.[voiceOptions.characterId] || {} : {};
       const identityProfile = characterVoiceProfile(voiceOptions.voiceIdentity, voiceOptions.characterId);
       const isNarrator = voiceOptions.role === 'narrator';
@@ -198,28 +229,76 @@
       utterance.voice = voices.find(voice => voice.name === requestedName)
         || voices.find(voice => /^sv(-|$)/i.test(voice.lang))
         || null;
+      utterance.onstart = () => {
+        if (token !== generation) return;
+        if (speechStartTimer !== null) win.clearTimeout(speechStartTimer);
+        speechStartTimer = null;
+        setState('SPEAKING', 'Uppläsningen har startat. Om du inte hör ljud, kontrollera iPadens volym och ljudutgång.');
+        if (typeof voiceOptions.onStart === 'function') voiceOptions.onStart();
+      };
       utterance.onend = () => {
         if (token !== generation) return;
         if (speechTimer !== null) win.clearTimeout(speechTimer);
+        if (speechStartTimer !== null) win.clearTimeout(speechStartTimer);
         speechTimer = null;
+        speechStartTimer = null;
+        currentUtterance = null;
         setState('IDLE');
       };
-      utterance.onerror = () => {
+      utterance.onerror = event => {
         if (token !== generation) return;
         if (speechTimer !== null) win.clearTimeout(speechTimer);
+        if (speechStartTimer !== null) win.clearTimeout(speechStartTimer);
         speechTimer = null;
+        speechStartTimer = null;
+        currentUtterance = null;
         generation += 1;
-        setState('IDLE', 'Uppläsningen avbröts. Dialogen finns kvar som text.');
+        const blocked = event?.error === 'not-allowed' || event?.error === 'service-not-allowed';
+        const message = blocked
+          ? 'Safari blockerade uppläsningen. Tryck på Läs senaste repliken för att starta ljudet.'
+          : 'Uppläsningen avbröts. Tryck på Läs senaste repliken för att försöka igen. Dialogen finns kvar som text.';
+        setState('IDLE', message);
       };
-      setState('SPEAKING', 'Läser upp dialog.');
+      setState('QUEUED', 'Startar uppläsningen.');
+      currentUtterance = utterance;
+      speechStartTimer = win.setTimeout(() => {
+        if (token !== generation || currentUtterance !== utterance) return;
+        speechStartTimer = null;
+        generation += 1;
+        currentUtterance = null;
+        if (speechTimer !== null) win.clearTimeout(speechTimer);
+        speechTimer = null;
+        // Drop a blocked native utterance now. A player retry can then call
+        // speak() directly from its button gesture instead of following a
+        // same-turn cancel() that older WebKit versions may discard.
+        try { win.speechSynthesis.cancel(); } catch (_) { /* Best effort. */ }
+        setState('IDLE', 'Uppläsningen startade inte. Tryck på Läs senaste repliken för att starta ljudet.');
+      }, 4000);
       speechTimer = win.setTimeout(() => {
         if (token !== generation) return;
         generation += 1;
         try { win.speechSynthesis.cancel(); } catch (_) { /* Best effort. */ }
+        currentUtterance = null;
+        if (speechStartTimer !== null) win.clearTimeout(speechStartTimer);
+        speechStartTimer = null;
         speechTimer = null;
         setState('IDLE', 'Uppläsningen avslutades. Dialogen finns kvar som text.');
       }, Math.max(30000, Math.min(180000, String(text).length * 180)));
+      const enqueue = () => {
+        if (token !== generation) return;
         try { win.speechSynthesis.speak(utterance); }
+        catch (_) {
+          currentUtterance = null;
+          cancelSpeech();
+          setState('IDLE', 'Talsyntesen kunde inte startas. Dialogen finns kvar som text.');
+        }
+      };
+      try {
+        // Give WebKit one event-loop turn to finish cancel() before replacing
+        // speech that was actively playing. Normal replies enqueue immediately.
+        if (hadQueuedUtterance) win.setTimeout(enqueue, 100);
+        else enqueue();
+      }
       catch (_) { cancelSpeech(); setState('IDLE', 'Talsyntesen kunde inte startas. Dialogen finns kvar som text.'); return false; }
       return true;
     }
@@ -230,7 +309,7 @@
     function getSettings() { return {...settings}; }
     function getVoices() { return availableVoices(); }
     function supportsRecognition() { return Boolean(win.SpeechRecognition || win.webkitSpeechRecognition); }
-    return {startListening, stopListening, speak, cancelSpeech, stopAll, update, getState, getSettings, getVoices, supportsRecognition};
+    return {startListening, stopListening, speak, cancelSpeech, stopAll, activateFromUserGesture, update, getState, getSettings, getVoices, supportsRecognition};
   }
 
   root.GameVoice = {createVoiceController, DEFAULT_SETTINGS, parseVoiceCommand, loadSettings, saveSettings, characterVoiceProfile};