fix(agent): allow system voice narration fallback

Generated-By: PostHog Code
Task-Id: ac30fada-8c29-4973-a253-08d70be31be6

Author: pauldambra

packages/agent/src/adapters/local-tools/tools/speak.ts

@@ -50,9 +50,9 @@ export const SPEAK_TOOL_DESCRIPTION =
  * it to the speech queue, exactly like completion/permission notifications are
  * pure side effects off the event stream. Gated on `spokenNarration`, which is
  * strictly opt-in (see `resolveSpokenNarration`): the desktop passes it true
- * only when the feature flag, the user's setting, and an ElevenLabs key are all
- * in place. Headless cloud runs (Slack threads, Signals scouts) never enable
- * it, so the tool and its instructions never load and never cost tokens there.
+ * only when the feature flag and the user's setting are both enabled. Headless
+ * cloud runs (Slack threads, Signals scouts) never enable it, so the tool and
+ * its instructions never load and never cost tokens there.
  */
 export const speakTool = defineLocalTool({
   name: SPEAK_TOOL_NAME,

packages/agent/src/adapters/session-meta.ts

@@ -23,12 +23,12 @@ interface SpokenNarrationSource {
 /**
  * Spoken narration is strictly opt-in: it is on only when a caller explicitly
  * sets `spokenNarration` true at session start. The desktop is the only client
- * that can play audio and the only place that knows the feature flag, the
- * user's setting, and whether an ElevenLabs key is configured — so it computes
- * that boolean and passes it. Everything else (headless cloud runs like Slack
- * threads and Signals scouts, sandboxes, local runs without the setting) stays
- * silent, so the `speak` tool and its instructions never load and never cost
- * tokens where nothing is listening. Shared by the Claude and Codex adapters.
+ * that can play audio and the only place that knows the feature flag and the
+ * user's setting, so it computes that boolean and passes it. Everything else
+ * (headless cloud runs like Slack threads and Signals scouts, sandboxes, local
+ * runs without the setting) stays silent, so the `speak` tool and its
+ * instructions never load and never cost tokens where nothing is listening.
+ * Shared by the Claude and Codex adapters.
  */
 export function resolveSpokenNarration(
   meta: SpokenNarrationSource | undefined,

packages/core/src/sessions/sessionService.ts

@@ -336,7 +336,7 @@ export interface SessionServiceDeps {
     rtkEnabledLocal?: boolean;
     rtkEnabledCloud?: boolean;
     spokenNotifications?: boolean;
-    elevenLabsKeyConfigured?: boolean;
+    spokenNarrationEnabled?: boolean;
   };
   usageLimit: { show: (...args: any[]) => any };
   readonly addDirectoryDialog: { open: boolean };
@@ -1092,15 +1092,15 @@ export class SessionService {
         customInstructions,
         rtkEnabledLocal,
         spokenNotifications,
-        elevenLabsKeyConfigured,
+        spokenNarrationEnabled,
       } = this.d.settings;
       const result = await this.d.trpc.agent.reconnect.mutate({
         taskId,
         taskRunId,
         repoPath,
         rtkEnabled: rtkEnabledLocal,
         spokenNarration:
-          spokenNotifications === true && elevenLabsKeyConfigured === true,
+          spokenNotifications === true && spokenNarrationEnabled === true,
         apiHost: auth.apiHost,
         projectId: auth.projectId,
         logUrl,
@@ -1424,7 +1424,7 @@ export class SessionService {
       customInstructions: startCustomInstructions,
       rtkEnabledLocal,
       spokenNotifications,
-      elevenLabsKeyConfigured,
+      spokenNarrationEnabled,
     } = this.d.settings;
     const preferredModel = model ?? this.d.DEFAULT_GATEWAY_MODEL;
     const result = await this.d.trpc.agent.start.mutate({
@@ -1438,7 +1438,7 @@ export class SessionService {
       customInstructions: startCustomInstructions || undefined,
       rtkEnabled: rtkEnabledLocal,
       spokenNarration:
-        spokenNotifications === true && elevenLabsKeyConfigured === true,
+        spokenNotifications === true && spokenNarrationEnabled === true,
       effort: effortLevelSchema.safeParse(reasoningLevel).success
         ? (reasoningLevel as EffortLevel)
         : undefined,

packages/ui/src/features/sessions/sessionServiceHost.ts

@@ -15,12 +15,17 @@ import {
   HOST_TRPC_CLIENT,
   type HostTrpcClient,
 } from "@posthog/host-router/client";
+import { SPOKEN_NARRATION_FLAG } from "@posthog/shared";
 import {
   createAuthenticatedClient,
   getAuthenticatedClient,
 } from "@posthog/ui/features/auth/authClientImperative";
 import { fetchAuthState } from "@posthog/ui/features/auth/authQueries";
 import { useUsageLimitStore } from "@posthog/ui/features/billing/usageLimitStore";
+import {
+  FEATURE_FLAGS,
+  type FeatureFlags,
+} from "@posthog/ui/features/feature-flags/identifiers";
 import { useAddDirectoryDialogStore } from "@posthog/ui/features/folder-picker/addDirectoryDialogStore";
 import { NotificationBus } from "@posthog/ui/features/notifications/notifications";
 import { SpeechNotifier } from "@posthog/ui/features/notifications/speechNotifier";
@@ -117,6 +122,10 @@ function buildSessionServiceDeps(): SessionServiceDeps {
       return {
         ...state,
         customInstructions: getEffectiveCustomInstructions(state),
+        spokenNarrationEnabled:
+          resolveService<FeatureFlags>(FEATURE_FLAGS).isEnabled(
+            SPOKEN_NARRATION_FLAG,
+          ) || import.meta.env.DEV,
       };
     },
     usageLimit: {

packages/workspace-server/src/services/agent/schemas.ts

@@ -94,8 +94,8 @@ export const startSessionInput = z.object({
   /**
    * The user's spoken-narration setting at session start. Gates the agent's
    * speak tool and its prompt instructions. Strictly opt-in: only the desktop
-   * sets it true (feature flag + setting + ElevenLabs key); when absent the
-   * adapter leaves narration off, so headless runs never load the tool.
+   * sets it true (feature flag + setting); when absent the adapter leaves
+   * narration off, so headless runs never load the tool.
    */
   spokenNarration: z.boolean().optional(),
 });