@plasius/ai-speech 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -18,6 +18,34 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - **Security**
   - (placeholder)
 
+## [0.1.7] - 2026-07-12
+
+- **Added**
+  - Player System audio contracts for narrated responses, localized cues, repeating warnings, priority/ducking policy, and combat-safe delivery under `isekai.player-system.audio.enabled`.
+
+- **Changed**
+  - (none)
+
+- **Fixed**
+  - (none)
+
+- **Security**
+  - Audio contracts use opaque utterance/cue identifiers and bounded warning delivery; raw speech text and provider credentials remain outside the package.
+
+## [0.1.6] - 2026-06-28
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - Refreshed development dependency baselines to `@types/node@26.0.1`, `@typescript-eslint/*@8.62.0`, `eslint@10.6.0`, `globals@17.7.0`, and `vitest@4.1.9`.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.1.5] - 2026-06-22
 
 - **Added**
@@ -54,3 +82,5 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 [0.1.1]: https://github.com/Plasius-LTD/ai-speech/releases/tag/v0.1.1
 [0.1.4]: https://github.com/Plasius-LTD/ai-speech/releases/tag/v0.1.4
 [0.1.5]: https://github.com/Plasius-LTD/ai-speech/releases/tag/v0.1.5
+[0.1.6]: https://github.com/Plasius-LTD/ai-speech/releases/tag/v0.1.6
+[0.1.7]: https://github.com/Plasius-LTD/ai-speech/releases/tag/v0.1.7

package/README.md

@@ -10,6 +10,8 @@ This package defines public contracts for:
 - cache-safe player address rendering
 - development, standard, and premium-character voice tier routing
 - cache telemetry payloads
+- Player System narrated responses, localized one-shot cues, and repeating warnings
+- priority, ducking, suppression, and combat-safe delivery policy
 
 It does not fetch remote feature flags, talk to providers, or store cache entries directly. Host applications and provider adapters remain responsible for runtime I/O.
 
@@ -81,6 +83,49 @@ console.log(voiceTier.resolvedTier);
 
 Default behavior is fail-closed when the caller does not provide a remote flag snapshot.
 
+## Player System audio contracts
+
+Player System audio is enabled by the remotely evaluated
+`isekai.player-system.audio.enabled` flag. The package keeps the three delivery
+channels distinct so hosts can apply separate UX and accessibility behavior:
+
+- `narrated-response` uses an opaque utterance ID and locale; raw speech text
+  stays with the host/provider pipeline.
+- `localized-cue` uses a stable cue ID, locale, and one of the exported families
+  `status`, `tutorial`, `mission`, `mcc`, or `warning`.
+- `repeating-warning` requires bounded repeat intervals and per-minute limits.
+
+Contracts carry `critical`, `high`, `normal`, or `low` priority plus an explicit
+ducking mode. Critical audio bypasses ducking. Combat-safe policy suppresses
+normal and low priority audio, allows high and critical audio, and can condense
+or defer narration according to the contract. Rollout-disabled, muted, duplicate,
+and explicitly suppressed dispatches fail closed with a reason code.
+
+```ts
+import {
+  AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,
+  createAiSpeechNarratedResponse,
+  resolveAiSpeechAudioPolicy,
+} from "@plasius/ai-speech";
+
+const narration = createAiSpeechNarratedResponse({
+  id: "tutorial-combat-hint",
+  utteranceId: "tutorial-combat-hint-v1",
+  locale: "en-GB",
+  priority: "high",
+  ducking: "music",
+  combatSafeDelivery: "condensed",
+});
+
+const decision = resolveAiSpeechAudioPolicy({
+  contract: narration,
+  focusMode: "combat-safe",
+  featureFlags: {
+    [AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID]: true,
+  },
+});
+```
+
 ## Cache Safety Rules
 
 - User names, account handles, and user-renamed character names are redacted to a generic label such as `Player`.

package/dist/index.cjs

@@ -20,6 +20,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AI_SPEECH_AUDIO_CHANNELS: () => AI_SPEECH_AUDIO_CHANNELS,
+  AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES: () => AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,
+  AI_SPEECH_AUDIO_CUE_FAMILIES: () => AI_SPEECH_AUDIO_CUE_FAMILIES,
+  AI_SPEECH_AUDIO_DUCKING_MODES: () => AI_SPEECH_AUDIO_DUCKING_MODES,
+  AI_SPEECH_AUDIO_FOCUS_MODES: () => AI_SPEECH_AUDIO_FOCUS_MODES,
+  AI_SPEECH_AUDIO_PRIORITIES: () => AI_SPEECH_AUDIO_PRIORITIES,
   AI_SPEECH_CACHE_MODES: () => AI_SPEECH_CACHE_MODES,
   AI_SPEECH_CACHE_SCOPES: () => AI_SPEECH_CACHE_SCOPES,
   AI_SPEECH_DEFAULT_PLAYER_LABEL: () => AI_SPEECH_DEFAULT_PLAYER_LABEL,
@@ -30,6 +36,7 @@ __export(index_exports, {
   AI_SPEECH_NEAR_REUSE_SAFE_CLASSES: () => AI_SPEECH_NEAR_REUSE_SAFE_CLASSES,
   AI_SPEECH_PACKAGE: () => AI_SPEECH_PACKAGE,
   AI_SPEECH_PLAYER_ADDRESS_SOURCES: () => AI_SPEECH_PLAYER_ADDRESS_SOURCES,
+  AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID: () => AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,
   AI_SPEECH_PROVIDER_CACHE_PERMISSIONS: () => AI_SPEECH_PROVIDER_CACHE_PERMISSIONS,
   AI_SPEECH_ROLLOUTS: () => AI_SPEECH_ROLLOUTS,
   AI_SPEECH_ROLLOUT_EVALUATORS: () => AI_SPEECH_ROLLOUT_EVALUATORS,
@@ -37,13 +44,17 @@ __export(index_exports, {
   AI_SPEECH_UTTERANCE_CLASSES: () => AI_SPEECH_UTTERANCE_CLASSES,
   AI_SPEECH_VOICE_TIERS: () => AI_SPEECH_VOICE_TIERS,
   createAiSpeechCacheKey: () => createAiSpeechCacheKey,
+  createAiSpeechLocalizedCue: () => createAiSpeechLocalizedCue,
+  createAiSpeechNarratedResponse: () => createAiSpeechNarratedResponse,
   createAiSpeechNearReuseFingerprint: () => createAiSpeechNearReuseFingerprint,
+  createAiSpeechRepeatingWarning: () => createAiSpeechRepeatingWarning,
   isAiSpeechFeatureEnabled: () => isAiSpeechFeatureEnabled,
   isAiSpeechNearReuseSafeClass: () => isAiSpeechNearReuseSafeClass,
   normalizeAiSpeechText: () => normalizeAiSpeechText,
   packageDescriptor: () => packageDescriptor,
   planAiSpeechCache: () => planAiSpeechCache,
   renderAiSpeechText: () => renderAiSpeechText,
+  resolveAiSpeechAudioPolicy: () => resolveAiSpeechAudioPolicy,
   resolveAiSpeechPlayerAddress: () => resolveAiSpeechPlayerAddress,
   resolveAiSpeechRolloutDecision: () => resolveAiSpeechRolloutDecision,
   resolveAiSpeechVoiceTier: () => resolveAiSpeechVoiceTier
@@ -377,6 +388,171 @@ function planAiSpeechCache(input) {
     reasonCodes: ["near-reuse-eligible"]
   };
 }
+var AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID = "isekai.player-system.audio.enabled";
+var AI_SPEECH_AUDIO_CHANNELS = [
+  "narrated-response",
+  "localized-cue",
+  "repeating-warning"
+];
+var AI_SPEECH_AUDIO_PRIORITIES = [
+  "critical",
+  "high",
+  "normal",
+  "low"
+];
+var AI_SPEECH_AUDIO_DUCKING_MODES = [
+  "none",
+  "music",
+  "non-critical",
+  "lower-priority"
+];
+var AI_SPEECH_AUDIO_CUE_FAMILIES = [
+  "status",
+  "tutorial",
+  "mission",
+  "mcc",
+  "warning"
+];
+var AI_SPEECH_AUDIO_FOCUS_MODES = [
+  "ambient",
+  "focused",
+  "combat-safe"
+];
+var AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES = [
+  "full",
+  "condensed",
+  "deferred",
+  "suppressed"
+];
+function requireAudioEnum(value, allowed, label) {
+  if (!allowed.includes(value)) {
+    throw new Error(`${label} is not supported: ${value}.`);
+  }
+  return value;
+}
+function requireBoundedAudioNumber(value, minimum, maximum, label) {
+  if (!Number.isFinite(value) || value < minimum || value > maximum) {
+    throw new Error(
+      `${label} must be between ${minimum} and ${maximum}, inclusive.`
+    );
+  }
+  return value;
+}
+function createAiSpeechAudioContractBase(input) {
+  return {
+    id: requireNonEmptyString(input.id, "Audio contract id"),
+    featureFlagId: AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,
+    priority: requireAudioEnum(
+      input.priority,
+      AI_SPEECH_AUDIO_PRIORITIES,
+      "Audio priority"
+    ),
+    ducking: requireAudioEnum(
+      input.ducking,
+      AI_SPEECH_AUDIO_DUCKING_MODES,
+      "Audio ducking mode"
+    ),
+    combatSafeDelivery: requireAudioEnum(
+      input.combatSafeDelivery,
+      AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,
+      "Combat-safe audio delivery"
+    )
+  };
+}
+function createAiSpeechNarratedResponse(input) {
+  return Object.freeze({
+    ...createAiSpeechAudioContractBase(input),
+    channel: "narrated-response",
+    utteranceId: requireNonEmptyString(input.utteranceId, "Utterance id"),
+    locale: requireNonEmptyString(input.locale, "Locale")
+  });
+}
+function createAiSpeechLocalizedCue(input) {
+  return Object.freeze({
+    ...createAiSpeechAudioContractBase(input),
+    channel: "localized-cue",
+    cueFamily: requireAudioEnum(
+      input.cueFamily,
+      AI_SPEECH_AUDIO_CUE_FAMILIES,
+      "Audio cue family"
+    ),
+    cueId: requireNonEmptyString(input.cueId, "Cue id"),
+    locale: requireNonEmptyString(input.locale, "Locale")
+  });
+}
+function createAiSpeechRepeatingWarning(input) {
+  return Object.freeze({
+    ...createAiSpeechAudioContractBase(input),
+    channel: "repeating-warning",
+    warningId: requireNonEmptyString(input.warningId, "Warning id"),
+    intervalSeconds: requireBoundedAudioNumber(
+      input.intervalSeconds,
+      1,
+      3600,
+      "Warning intervalSeconds"
+    ),
+    maximumOccurrencesPerMinute: requireBoundedAudioNumber(
+      input.maximumOccurrencesPerMinute,
+      1,
+      60,
+      "Warning maximumOccurrencesPerMinute"
+    )
+  });
+}
+function isPlayerSystemAudioEnabled(featureFlags = {}) {
+  return featureFlags[AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID] === true;
+}
+function resolveAiSpeechAudioPolicy(input) {
+  const { contract } = input;
+  if (!isPlayerSystemAudioEnabled(input.featureFlags)) {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["player-system-audio-rollout-disabled"]
+    };
+  }
+  if (input.masterMuted || input.userMuted) {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: [input.masterMuted ? "master-muted" : "user-muted"]
+    };
+  }
+  if (input.activeContractIds?.includes(contract.id)) {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["duplicate-audio-contract-suppressed"]
+    };
+  }
+  if (input.focusMode === "combat-safe" && contract.priority !== "critical" && contract.priority !== "high") {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["combat-safe-priority-suppressed"]
+    };
+  }
+  if (contract.combatSafeDelivery === "suppressed") {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["audio-contract-suppressed"]
+    };
+  }
+  const mode = input.focusMode === "combat-safe" ? contract.combatSafeDelivery === "condensed" ? "condensed" : contract.combatSafeDelivery === "deferred" ? "deferred" : "full" : "full";
+  const ducking = contract.priority === "critical" ? "none" : contract.ducking;
+  return {
+    deliver: mode !== "deferred",
+    mode,
+    ducking,
+    reasonCodes: contract.priority === "critical" ? ["critical-priority-bypasses-ducking"] : []
+  };
+}
 var packageDescriptor = Object.freeze({
   packageName: AI_SPEECH_PACKAGE,
   featureFlagId: AI_SPEECH_FEATURE_FLAG_ID,
@@ -385,6 +561,12 @@ var packageDescriptor = Object.freeze({
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AI_SPEECH_AUDIO_CHANNELS,
+  AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,
+  AI_SPEECH_AUDIO_CUE_FAMILIES,
+  AI_SPEECH_AUDIO_DUCKING_MODES,
+  AI_SPEECH_AUDIO_FOCUS_MODES,
+  AI_SPEECH_AUDIO_PRIORITIES,
   AI_SPEECH_CACHE_MODES,
   AI_SPEECH_CACHE_SCOPES,
   AI_SPEECH_DEFAULT_PLAYER_LABEL,
@@ -395,6 +577,7 @@ var packageDescriptor = Object.freeze({
   AI_SPEECH_NEAR_REUSE_SAFE_CLASSES,
   AI_SPEECH_PACKAGE,
   AI_SPEECH_PLAYER_ADDRESS_SOURCES,
+  AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,
   AI_SPEECH_PROVIDER_CACHE_PERMISSIONS,
   AI_SPEECH_ROLLOUTS,
   AI_SPEECH_ROLLOUT_EVALUATORS,
@@ -402,13 +585,17 @@ var packageDescriptor = Object.freeze({
   AI_SPEECH_UTTERANCE_CLASSES,
   AI_SPEECH_VOICE_TIERS,
   createAiSpeechCacheKey,
+  createAiSpeechLocalizedCue,
+  createAiSpeechNarratedResponse,
   createAiSpeechNearReuseFingerprint,
+  createAiSpeechRepeatingWarning,
   isAiSpeechFeatureEnabled,
   isAiSpeechNearReuseSafeClass,
   normalizeAiSpeechText,
   packageDescriptor,
   planAiSpeechCache,
   renderAiSpeechText,
+  resolveAiSpeechAudioPolicy,
   resolveAiSpeechPlayerAddress,
   resolveAiSpeechRolloutDecision,
   resolveAiSpeechVoiceTier

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface AiPackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nfunction requireNonEmptyString(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new Error(`${label} must be a non-empty string.`);\n  }\n\n  return trimmed;\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/gu, \" \").trim();\n}\n\nexport const AI_SPEECH_PACKAGE = \"@plasius/ai-speech\";\nexport const AI_SPEECH_ENV_PREFIX = \"AI_SPEECH\";\n\nexport const AI_SPEECH_FEATURE_FLAGS = {\n  ttsCache: \"ai.tts.cache.enabled\",\n  ttsNearReuse: \"ai.tts.near-reuse.enabled\",\n  premiumCharacters: \"ai.tts.premium-characters.enabled\",\n} as const;\n\nexport type AiSpeechFeatureFlagKey =\n  (typeof AI_SPEECH_FEATURE_FLAGS)[keyof typeof AI_SPEECH_FEATURE_FLAGS];\n\nexport type AiSpeechFeatureFlagSnapshot = Readonly<\n  Record<string, boolean | undefined>\n>;\n\nexport const AI_SPEECH_FEATURE_FLAG_ID = AI_SPEECH_FEATURE_FLAGS.ttsCache;\n\nexport const AI_SPEECH_ROLLOUT_EVALUATORS = [\n  \"remote-flag-service\",\n  \"host-application\",\n  \"break-glass-env\",\n] as const;\n\nexport type AiSpeechRolloutEvaluator =\n  (typeof AI_SPEECH_ROLLOUT_EVALUATORS)[number];\n\nexport const AI_SPEECH_ROLLOUT_FALLBACK_MODES = [\n  \"fail-closed\",\n  \"fail-open\",\n] as const;\n\nexport type AiSpeechRolloutFallbackMode =\n  (typeof AI_SPEECH_ROLLOUT_FALLBACK_MODES)[number];\n\nexport interface AiSpeechRolloutControl {\n  readonly featureFlag: AiSpeechFeatureFlagKey;\n  readonly evaluator: AiSpeechRolloutEvaluator;\n  readonly defaultEnabled: boolean;\n  readonly fallbackMode: AiSpeechRolloutFallbackMode;\n}\n\nexport interface AiSpeechRolloutDecision extends AiSpeechRolloutControl {\n  readonly enabled: boolean;\n  readonly source: \"snapshot\" | \"default\";\n}\n\nexport const AI_SPEECH_ROLLOUTS = Object.freeze({\n  ttsCache: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  ttsNearReuse: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  premiumCharacters: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n});\n\nexport function resolveAiSpeechRolloutDecision(\n  control: AiSpeechRolloutControl,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): AiSpeechRolloutDecision {\n  const resolved = snapshot[control.featureFlag];\n  if (typeof resolved === \"boolean\") {\n    return {\n      ...control,\n      enabled: resolved,\n      source: \"snapshot\",\n    };\n  }\n\n  return {\n    ...control,\n    enabled: control.defaultEnabled,\n    source: \"default\",\n  };\n}\n\nexport function isAiSpeechFeatureEnabled(\n  featureFlag: AiSpeechFeatureFlagKey,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): boolean {\n  const control = Object.values(AI_SPEECH_ROLLOUTS).find(\n    (candidate) => candidate.featureFlag === featureFlag\n  );\n\n  if (!control) {\n    return false;\n  }\n\n  return resolveAiSpeechRolloutDecision(control, snapshot).enabled;\n}\n\nexport const AI_SPEECH_VOICE_TIERS = [\n  \"development\",\n  \"standard\",\n  \"premium-character\",\n] as const;\n\nexport type AiSpeechVoiceTier = (typeof AI_SPEECH_VOICE_TIERS)[number];\n\nexport const AI_SPEECH_ENVIRONMENTS = [\n  \"development\",\n  \"preview\",\n  \"production\",\n] as const;\n\nexport type AiSpeechEnvironment = (typeof AI_SPEECH_ENVIRONMENTS)[number];\n\nexport interface AiSpeechVoiceTierDecision {\n  readonly requestedTier: AiSpeechVoiceTier;\n  readonly resolvedTier: AiSpeechVoiceTier;\n  readonly fallbackTier?: AiSpeechVoiceTier;\n  readonly reasonCodes: readonly string[];\n}\n\nexport interface ResolveAiSpeechVoiceTierInput {\n  readonly environment: AiSpeechEnvironment;\n  readonly requestedTier?: AiSpeechVoiceTier;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n}\n\nexport function resolveAiSpeechVoiceTier(\n  input: ResolveAiSpeechVoiceTierInput\n): AiSpeechVoiceTierDecision {\n  const requestedTier =\n    input.requestedTier ??\n    (input.environment === \"development\" ? \"development\" : \"standard\");\n\n  if (\n    requestedTier === \"premium-character\" &&\n    !isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n      input.featureFlags\n    )\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"premium-character-rollout-disabled\"],\n    };\n  }\n\n  if (\n    requestedTier === \"development\" &&\n    input.environment !== \"development\"\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"development-voices-limited-to-development-environments\"],\n    };\n  }\n\n  return {\n    requestedTier,\n    resolvedTier: requestedTier,\n    reasonCodes: [],\n  };\n}\n\nexport const AI_SPEECH_PLAYER_ADDRESS_SOURCES = [\n  \"generic-player\",\n  \"class-title\",\n  \"faction-title\",\n  \"authored-character\",\n  \"user-name\",\n  \"account-handle\",\n  \"user-renamed-character\",\n] as const;\n\nexport type AiSpeechPlayerAddressSource =\n  (typeof AI_SPEECH_PLAYER_ADDRESS_SOURCES)[number];\n\nexport const AI_SPEECH_DEFAULT_PLAYER_LABEL = \"Player\";\n\nexport interface AiSpeechPlayerAddressInput {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly rawValue?: string;\n  readonly fallbackLabel?: string;\n}\n\nexport interface AiSpeechPlayerAddressDecision {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly renderText: string;\n  readonly exactReuseAllowed: boolean;\n  readonly nearReuseAllowed: boolean;\n  readonly redacted: boolean;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function resolveAiSpeechPlayerAddress(\n  input: AiSpeechPlayerAddressInput\n): AiSpeechPlayerAddressDecision {\n  const fallbackLabel =\n    normalizeWhitespace(input.fallbackLabel ?? \"\") ||\n    AI_SPEECH_DEFAULT_PLAYER_LABEL;\n  const rawValue = normalizeWhitespace(input.rawValue ?? \"\");\n\n  switch (input.source) {\n    case \"generic-player\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: [\"generic-player-address\"],\n      };\n    case \"class-title\":\n    case \"faction-title\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"authored-character\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"user-name\":\n    case \"account-handle\":\n    case \"user-renamed-character\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: false,\n        redacted: true,\n        reasonCodes: [\"player-identifier-redacted-from-render-text\"],\n      };\n  }\n}\n\nexport interface AiSpeechRenderTextInput {\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n}\n\nexport interface AiSpeechRenderTextResult {\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n}\n\nexport function renderAiSpeechText(\n  input: AiSpeechRenderTextInput\n): AiSpeechRenderTextResult {\n  const textTemplate = requireNonEmptyString(\n    input.textTemplate,\n    \"Speech text template\"\n  );\n  const hasPlayerPlaceholder = textTemplate.includes(\"{playerAddress}\");\n\n  if (hasPlayerPlaceholder && !input.playerAddress) {\n    throw new Error(\n      \"Speech text template requires playerAddress when using the {playerAddress} placeholder.\"\n    );\n  }\n\n  const playerAddress = input.playerAddress\n    ? resolveAiSpeechPlayerAddress(input.playerAddress)\n    : undefined;\n  const renderText = normalizeWhitespace(\n    hasPlayerPlaceholder && playerAddress\n      ? textTemplate.replace(/\\{playerAddress\\}/gu, playerAddress.renderText)\n      : textTemplate\n  );\n\n  return {\n    renderText,\n    normalizedRenderText: normalizeAiSpeechText(renderText),\n    playerAddress,\n  };\n}\n\nexport function normalizeAiSpeechText(value: string): string {\n  return requireNonEmptyString(\n    normalizeWhitespace(value).toLocaleLowerCase(\"en-GB\"),\n    \"Speech text\"\n  );\n}\n\nexport const AI_SPEECH_PROVIDER_CACHE_PERMISSIONS = [\n  \"forbidden\",\n  \"exact-only\",\n  \"exact-and-near\",\n] as const;\n\nexport type AiSpeechProviderCachePermission =\n  (typeof AI_SPEECH_PROVIDER_CACHE_PERMISSIONS)[number];\n\nexport const AI_SPEECH_CACHE_MODES = [\n  \"disabled\",\n  \"no-cache\",\n  \"exact\",\n  \"near\",\n] as const;\n\nexport type AiSpeechCacheMode = (typeof AI_SPEECH_CACHE_MODES)[number];\n\nexport const AI_SPEECH_CACHE_SCOPES = [\"none\", \"actor\", \"global\"] as const;\n\nexport type AiSpeechCacheScope = (typeof AI_SPEECH_CACHE_SCOPES)[number];\n\nexport const AI_SPEECH_UTTERANCE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n  \"moderation-notice\",\n  \"private-response\",\n] as const;\n\nexport type AiSpeechUtteranceClass =\n  (typeof AI_SPEECH_UTTERANCE_CLASSES)[number];\n\nexport const AI_SPEECH_NEAR_REUSE_SAFE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n] as const satisfies readonly AiSpeechUtteranceClass[];\n\nconst AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET: ReadonlySet<AiSpeechUtteranceClass> =\n  new Set(AI_SPEECH_NEAR_REUSE_SAFE_CLASSES);\n\nexport interface AiSpeechCacheKeyInput {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly normalizedRenderText: string;\n  readonly styleId?: string;\n  readonly scopeDiscriminator?: string;\n}\n\nexport interface AiSpeechVoiceProfileRef {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly styleId?: string;\n  readonly cachePermission: AiSpeechProviderCachePermission;\n  readonly tier?: AiSpeechVoiceTier;\n  readonly profileId?: string;\n}\n\nexport interface AiSpeechCacheTelemetry {\n  readonly cacheHits: number;\n  readonly nearCacheHits: number;\n  readonly cacheMisses: number;\n  readonly charactersSaved: number;\n  readonly estimatedCostSavedUsd?: number;\n  readonly voiceProfileIds?: readonly string[];\n}\n\nexport interface PlanAiSpeechCacheInput {\n  readonly utteranceClass: AiSpeechUtteranceClass;\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n  readonly voice: AiSpeechVoiceProfileRef;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n  readonly actorScopeKey?: string;\n  readonly containsPersonalData?: boolean;\n  readonly containsPrivateContext?: boolean;\n  readonly containsModerationNotice?: boolean;\n}\n\nexport interface AiSpeechCachePlan {\n  readonly mode: AiSpeechCacheMode;\n  readonly sharingScope: AiSpeechCacheScope;\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly exactKey?: string;\n  readonly nearKey?: string;\n  readonly enabledFeatureFlags: readonly AiSpeechFeatureFlagKey[];\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function createAiSpeechCacheKey(input: AiSpeechCacheKeyInput): string {\n  const scopeDiscriminator = normalizeWhitespace(input.scopeDiscriminator ?? \"\");\n  return [\n    requireNonEmptyString(input.providerId, \"Provider id\"),\n    requireNonEmptyString(input.modelId, \"Model id\"),\n    requireNonEmptyString(input.voiceId, \"Voice id\"),\n    requireNonEmptyString(input.locale, \"Locale\"),\n    normalizeWhitespace(input.styleId ?? \"\") || \"_\",\n    requireNonEmptyString(input.format, \"Format\"),\n    requireNonEmptyString(\n      input.pronunciationVersion,\n      \"Pronunciation version\"\n    ),\n    scopeDiscriminator || \"global\",\n    normalizeAiSpeechText(input.normalizedRenderText),\n  ]\n    .map((segment) => encodeURIComponent(segment))\n    .join(\"::\");\n}\n\nexport function createAiSpeechNearReuseFingerprint(value: string): string {\n  const normalized = normalizeAiSpeechText(value)\n    .replace(/[^a-z0-9\\s]/gu, \" \")\n    .replace(/\\s+/gu, \" \")\n    .trim();\n\n  return requireNonEmptyString(normalized, \"Near-reuse fingerprint\");\n}\n\nexport function isAiSpeechNearReuseSafeClass(\n  utteranceClass: AiSpeechUtteranceClass\n): boolean {\n  return AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET.has(utteranceClass);\n}\n\nexport function planAiSpeechCache(\n  input: PlanAiSpeechCacheInput\n): AiSpeechCachePlan {\n  const rendered = renderAiSpeechText({\n    textTemplate: input.textTemplate,\n    playerAddress: input.playerAddress,\n  });\n  const enabledFeatureFlags: AiSpeechFeatureFlagKey[] = [];\n  const cacheEnabled = isAiSpeechFeatureEnabled(\n    AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    input.featureFlags\n  );\n\n  if (!cacheEnabled) {\n    return {\n      mode: \"disabled\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"tts-cache-rollout-disabled\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsCache);\n\n  if (input.voice.cachePermission === \"forbidden\") {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"provider-forbids-tts-caching\"],\n    };\n  }\n\n  const containsSensitiveContent =\n    Boolean(input.containsPersonalData) ||\n    Boolean(input.containsPrivateContext) ||\n    Boolean(input.containsModerationNotice) ||\n    Boolean(rendered.playerAddress?.redacted);\n  const actorScopeKey = normalizeWhitespace(input.actorScopeKey ?? \"\");\n\n  const actorScopeRequired =\n    containsSensitiveContent || input.utteranceClass === \"private-response\";\n\n  if (actorScopeRequired && !actorScopeKey) {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"actor-scope-key-required-for-sensitive-cache-entry\"],\n    };\n  }\n\n  const exactKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: rendered.normalizedRenderText,\n    scopeDiscriminator: actorScopeRequired ? actorScopeKey : undefined,\n  });\n\n  const nearReuseEnabled =\n    input.voice.cachePermission === \"exact-and-near\" &&\n    isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n      input.featureFlags\n    ) &&\n    isAiSpeechNearReuseSafeClass(input.utteranceClass) &&\n    !containsSensitiveContent &&\n    (rendered.playerAddress?.nearReuseAllowed ?? true);\n\n  if (!nearReuseEnabled) {\n    return {\n      mode: \"exact\",\n      sharingScope: actorScopeRequired ? \"actor\" : \"global\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      exactKey,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: containsSensitiveContent\n        ? [\"exact-cache-only-for-sensitive-or-redacted-content\"]\n        : [\"near-reuse-disabled-or-ineligible\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsNearReuse);\n\n  const nearKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: createAiSpeechNearReuseFingerprint(\n      rendered.normalizedRenderText\n    ),\n  });\n\n  return {\n    mode: \"near\",\n    sharingScope: \"global\",\n    renderText: rendered.renderText,\n    normalizedRenderText: rendered.normalizedRenderText,\n    exactKey,\n    nearKey,\n    enabledFeatureFlags,\n    playerAddress: rendered.playerAddress,\n    reasonCodes: [\"near-reuse-eligible\"],\n  };\n}\n\nexport const packageDescriptor: AiPackageDescriptor = Object.freeze({\n  packageName: AI_SPEECH_PACKAGE,\n  featureFlagId: AI_SPEECH_FEATURE_FLAG_ID,\n  envPrefix: AI_SPEECH_ENV_PREFIX,\n  summary:\n    \"Speech orchestration, TTS cache contracts, STT/TTS routing, and voice tier policy for Plasius AI.\",\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface AiPackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nfunction requireNonEmptyString(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new Error(`${label} must be a non-empty string.`);\n  }\n\n  return trimmed;\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/gu, \" \").trim();\n}\n\nexport const AI_SPEECH_PACKAGE = \"@plasius/ai-speech\";\nexport const AI_SPEECH_ENV_PREFIX = \"AI_SPEECH\";\n\nexport const AI_SPEECH_FEATURE_FLAGS = {\n  ttsCache: \"ai.tts.cache.enabled\",\n  ttsNearReuse: \"ai.tts.near-reuse.enabled\",\n  premiumCharacters: \"ai.tts.premium-characters.enabled\",\n} as const;\n\nexport type AiSpeechFeatureFlagKey =\n  (typeof AI_SPEECH_FEATURE_FLAGS)[keyof typeof AI_SPEECH_FEATURE_FLAGS];\n\nexport type AiSpeechFeatureFlagSnapshot = Readonly<\n  Record<string, boolean | undefined>\n>;\n\nexport const AI_SPEECH_FEATURE_FLAG_ID = AI_SPEECH_FEATURE_FLAGS.ttsCache;\n\nexport const AI_SPEECH_ROLLOUT_EVALUATORS = [\n  \"remote-flag-service\",\n  \"host-application\",\n  \"break-glass-env\",\n] as const;\n\nexport type AiSpeechRolloutEvaluator =\n  (typeof AI_SPEECH_ROLLOUT_EVALUATORS)[number];\n\nexport const AI_SPEECH_ROLLOUT_FALLBACK_MODES = [\n  \"fail-closed\",\n  \"fail-open\",\n] as const;\n\nexport type AiSpeechRolloutFallbackMode =\n  (typeof AI_SPEECH_ROLLOUT_FALLBACK_MODES)[number];\n\nexport interface AiSpeechRolloutControl {\n  readonly featureFlag: AiSpeechFeatureFlagKey;\n  readonly evaluator: AiSpeechRolloutEvaluator;\n  readonly defaultEnabled: boolean;\n  readonly fallbackMode: AiSpeechRolloutFallbackMode;\n}\n\nexport interface AiSpeechRolloutDecision extends AiSpeechRolloutControl {\n  readonly enabled: boolean;\n  readonly source: \"snapshot\" | \"default\";\n}\n\nexport const AI_SPEECH_ROLLOUTS = Object.freeze({\n  ttsCache: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  ttsNearReuse: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  premiumCharacters: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n});\n\nexport function resolveAiSpeechRolloutDecision(\n  control: AiSpeechRolloutControl,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): AiSpeechRolloutDecision {\n  const resolved = snapshot[control.featureFlag];\n  if (typeof resolved === \"boolean\") {\n    return {\n      ...control,\n      enabled: resolved,\n      source: \"snapshot\",\n    };\n  }\n\n  return {\n    ...control,\n    enabled: control.defaultEnabled,\n    source: \"default\",\n  };\n}\n\nexport function isAiSpeechFeatureEnabled(\n  featureFlag: AiSpeechFeatureFlagKey,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): boolean {\n  const control = Object.values(AI_SPEECH_ROLLOUTS).find(\n    (candidate) => candidate.featureFlag === featureFlag\n  );\n\n  if (!control) {\n    return false;\n  }\n\n  return resolveAiSpeechRolloutDecision(control, snapshot).enabled;\n}\n\nexport const AI_SPEECH_VOICE_TIERS = [\n  \"development\",\n  \"standard\",\n  \"premium-character\",\n] as const;\n\nexport type AiSpeechVoiceTier = (typeof AI_SPEECH_VOICE_TIERS)[number];\n\nexport const AI_SPEECH_ENVIRONMENTS = [\n  \"development\",\n  \"preview\",\n  \"production\",\n] as const;\n\nexport type AiSpeechEnvironment = (typeof AI_SPEECH_ENVIRONMENTS)[number];\n\nexport interface AiSpeechVoiceTierDecision {\n  readonly requestedTier: AiSpeechVoiceTier;\n  readonly resolvedTier: AiSpeechVoiceTier;\n  readonly fallbackTier?: AiSpeechVoiceTier;\n  readonly reasonCodes: readonly string[];\n}\n\nexport interface ResolveAiSpeechVoiceTierInput {\n  readonly environment: AiSpeechEnvironment;\n  readonly requestedTier?: AiSpeechVoiceTier;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n}\n\nexport function resolveAiSpeechVoiceTier(\n  input: ResolveAiSpeechVoiceTierInput\n): AiSpeechVoiceTierDecision {\n  const requestedTier =\n    input.requestedTier ??\n    (input.environment === \"development\" ? \"development\" : \"standard\");\n\n  if (\n    requestedTier === \"premium-character\" &&\n    !isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n      input.featureFlags\n    )\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"premium-character-rollout-disabled\"],\n    };\n  }\n\n  if (\n    requestedTier === \"development\" &&\n    input.environment !== \"development\"\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"development-voices-limited-to-development-environments\"],\n    };\n  }\n\n  return {\n    requestedTier,\n    resolvedTier: requestedTier,\n    reasonCodes: [],\n  };\n}\n\nexport const AI_SPEECH_PLAYER_ADDRESS_SOURCES = [\n  \"generic-player\",\n  \"class-title\",\n  \"faction-title\",\n  \"authored-character\",\n  \"user-name\",\n  \"account-handle\",\n  \"user-renamed-character\",\n] as const;\n\nexport type AiSpeechPlayerAddressSource =\n  (typeof AI_SPEECH_PLAYER_ADDRESS_SOURCES)[number];\n\nexport const AI_SPEECH_DEFAULT_PLAYER_LABEL = \"Player\";\n\nexport interface AiSpeechPlayerAddressInput {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly rawValue?: string;\n  readonly fallbackLabel?: string;\n}\n\nexport interface AiSpeechPlayerAddressDecision {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly renderText: string;\n  readonly exactReuseAllowed: boolean;\n  readonly nearReuseAllowed: boolean;\n  readonly redacted: boolean;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function resolveAiSpeechPlayerAddress(\n  input: AiSpeechPlayerAddressInput\n): AiSpeechPlayerAddressDecision {\n  const fallbackLabel =\n    normalizeWhitespace(input.fallbackLabel ?? \"\") ||\n    AI_SPEECH_DEFAULT_PLAYER_LABEL;\n  const rawValue = normalizeWhitespace(input.rawValue ?? \"\");\n\n  switch (input.source) {\n    case \"generic-player\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: [\"generic-player-address\"],\n      };\n    case \"class-title\":\n    case \"faction-title\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"authored-character\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"user-name\":\n    case \"account-handle\":\n    case \"user-renamed-character\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: false,\n        redacted: true,\n        reasonCodes: [\"player-identifier-redacted-from-render-text\"],\n      };\n  }\n}\n\nexport interface AiSpeechRenderTextInput {\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n}\n\nexport interface AiSpeechRenderTextResult {\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n}\n\nexport function renderAiSpeechText(\n  input: AiSpeechRenderTextInput\n): AiSpeechRenderTextResult {\n  const textTemplate = requireNonEmptyString(\n    input.textTemplate,\n    \"Speech text template\"\n  );\n  const hasPlayerPlaceholder = textTemplate.includes(\"{playerAddress}\");\n\n  if (hasPlayerPlaceholder && !input.playerAddress) {\n    throw new Error(\n      \"Speech text template requires playerAddress when using the {playerAddress} placeholder.\"\n    );\n  }\n\n  const playerAddress = input.playerAddress\n    ? resolveAiSpeechPlayerAddress(input.playerAddress)\n    : undefined;\n  const renderText = normalizeWhitespace(\n    hasPlayerPlaceholder && playerAddress\n      ? textTemplate.replace(/\\{playerAddress\\}/gu, playerAddress.renderText)\n      : textTemplate\n  );\n\n  return {\n    renderText,\n    normalizedRenderText: normalizeAiSpeechText(renderText),\n    playerAddress,\n  };\n}\n\nexport function normalizeAiSpeechText(value: string): string {\n  return requireNonEmptyString(\n    normalizeWhitespace(value).toLocaleLowerCase(\"en-GB\"),\n    \"Speech text\"\n  );\n}\n\nexport const AI_SPEECH_PROVIDER_CACHE_PERMISSIONS = [\n  \"forbidden\",\n  \"exact-only\",\n  \"exact-and-near\",\n] as const;\n\nexport type AiSpeechProviderCachePermission =\n  (typeof AI_SPEECH_PROVIDER_CACHE_PERMISSIONS)[number];\n\nexport const AI_SPEECH_CACHE_MODES = [\n  \"disabled\",\n  \"no-cache\",\n  \"exact\",\n  \"near\",\n] as const;\n\nexport type AiSpeechCacheMode = (typeof AI_SPEECH_CACHE_MODES)[number];\n\nexport const AI_SPEECH_CACHE_SCOPES = [\"none\", \"actor\", \"global\"] as const;\n\nexport type AiSpeechCacheScope = (typeof AI_SPEECH_CACHE_SCOPES)[number];\n\nexport const AI_SPEECH_UTTERANCE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n  \"moderation-notice\",\n  \"private-response\",\n] as const;\n\nexport type AiSpeechUtteranceClass =\n  (typeof AI_SPEECH_UTTERANCE_CLASSES)[number];\n\nexport const AI_SPEECH_NEAR_REUSE_SAFE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n] as const satisfies readonly AiSpeechUtteranceClass[];\n\nconst AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET: ReadonlySet<AiSpeechUtteranceClass> =\n  new Set(AI_SPEECH_NEAR_REUSE_SAFE_CLASSES);\n\nexport interface AiSpeechCacheKeyInput {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly normalizedRenderText: string;\n  readonly styleId?: string;\n  readonly scopeDiscriminator?: string;\n}\n\nexport interface AiSpeechVoiceProfileRef {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly styleId?: string;\n  readonly cachePermission: AiSpeechProviderCachePermission;\n  readonly tier?: AiSpeechVoiceTier;\n  readonly profileId?: string;\n}\n\nexport interface AiSpeechCacheTelemetry {\n  readonly cacheHits: number;\n  readonly nearCacheHits: number;\n  readonly cacheMisses: number;\n  readonly charactersSaved: number;\n  readonly estimatedCostSavedUsd?: number;\n  readonly voiceProfileIds?: readonly string[];\n}\n\nexport interface PlanAiSpeechCacheInput {\n  readonly utteranceClass: AiSpeechUtteranceClass;\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n  readonly voice: AiSpeechVoiceProfileRef;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n  readonly actorScopeKey?: string;\n  readonly containsPersonalData?: boolean;\n  readonly containsPrivateContext?: boolean;\n  readonly containsModerationNotice?: boolean;\n}\n\nexport interface AiSpeechCachePlan {\n  readonly mode: AiSpeechCacheMode;\n  readonly sharingScope: AiSpeechCacheScope;\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly exactKey?: string;\n  readonly nearKey?: string;\n  readonly enabledFeatureFlags: readonly AiSpeechFeatureFlagKey[];\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function createAiSpeechCacheKey(input: AiSpeechCacheKeyInput): string {\n  const scopeDiscriminator = normalizeWhitespace(input.scopeDiscriminator ?? \"\");\n  return [\n    requireNonEmptyString(input.providerId, \"Provider id\"),\n    requireNonEmptyString(input.modelId, \"Model id\"),\n    requireNonEmptyString(input.voiceId, \"Voice id\"),\n    requireNonEmptyString(input.locale, \"Locale\"),\n    normalizeWhitespace(input.styleId ?? \"\") || \"_\",\n    requireNonEmptyString(input.format, \"Format\"),\n    requireNonEmptyString(\n      input.pronunciationVersion,\n      \"Pronunciation version\"\n    ),\n    scopeDiscriminator || \"global\",\n    normalizeAiSpeechText(input.normalizedRenderText),\n  ]\n    .map((segment) => encodeURIComponent(segment))\n    .join(\"::\");\n}\n\nexport function createAiSpeechNearReuseFingerprint(value: string): string {\n  const normalized = normalizeAiSpeechText(value)\n    .replace(/[^a-z0-9\\s]/gu, \" \")\n    .replace(/\\s+/gu, \" \")\n    .trim();\n\n  return requireNonEmptyString(normalized, \"Near-reuse fingerprint\");\n}\n\nexport function isAiSpeechNearReuseSafeClass(\n  utteranceClass: AiSpeechUtteranceClass\n): boolean {\n  return AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET.has(utteranceClass);\n}\n\nexport function planAiSpeechCache(\n  input: PlanAiSpeechCacheInput\n): AiSpeechCachePlan {\n  const rendered = renderAiSpeechText({\n    textTemplate: input.textTemplate,\n    playerAddress: input.playerAddress,\n  });\n  const enabledFeatureFlags: AiSpeechFeatureFlagKey[] = [];\n  const cacheEnabled = isAiSpeechFeatureEnabled(\n    AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    input.featureFlags\n  );\n\n  if (!cacheEnabled) {\n    return {\n      mode: \"disabled\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"tts-cache-rollout-disabled\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsCache);\n\n  if (input.voice.cachePermission === \"forbidden\") {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"provider-forbids-tts-caching\"],\n    };\n  }\n\n  const containsSensitiveContent =\n    Boolean(input.containsPersonalData) ||\n    Boolean(input.containsPrivateContext) ||\n    Boolean(input.containsModerationNotice) ||\n    Boolean(rendered.playerAddress?.redacted);\n  const actorScopeKey = normalizeWhitespace(input.actorScopeKey ?? \"\");\n\n  const actorScopeRequired =\n    containsSensitiveContent || input.utteranceClass === \"private-response\";\n\n  if (actorScopeRequired && !actorScopeKey) {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"actor-scope-key-required-for-sensitive-cache-entry\"],\n    };\n  }\n\n  const exactKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: rendered.normalizedRenderText,\n    scopeDiscriminator: actorScopeRequired ? actorScopeKey : undefined,\n  });\n\n  const nearReuseEnabled =\n    input.voice.cachePermission === \"exact-and-near\" &&\n    isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n      input.featureFlags\n    ) &&\n    isAiSpeechNearReuseSafeClass(input.utteranceClass) &&\n    !containsSensitiveContent &&\n    (rendered.playerAddress?.nearReuseAllowed ?? true);\n\n  if (!nearReuseEnabled) {\n    return {\n      mode: \"exact\",\n      sharingScope: actorScopeRequired ? \"actor\" : \"global\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      exactKey,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: containsSensitiveContent\n        ? [\"exact-cache-only-for-sensitive-or-redacted-content\"]\n        : [\"near-reuse-disabled-or-ineligible\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsNearReuse);\n\n  const nearKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: createAiSpeechNearReuseFingerprint(\n      rendered.normalizedRenderText\n    ),\n  });\n\n  return {\n    mode: \"near\",\n    sharingScope: \"global\",\n    renderText: rendered.renderText,\n    normalizedRenderText: rendered.normalizedRenderText,\n    exactKey,\n    nearKey,\n    enabledFeatureFlags,\n    playerAddress: rendered.playerAddress,\n    reasonCodes: [\"near-reuse-eligible\"],\n  };\n}\n\nexport const AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID =\n  \"isekai.player-system.audio.enabled\" as const;\n\nexport const AI_SPEECH_AUDIO_CHANNELS = [\n  \"narrated-response\",\n  \"localized-cue\",\n  \"repeating-warning\",\n] as const;\n\nexport type AiSpeechAudioChannel = (typeof AI_SPEECH_AUDIO_CHANNELS)[number];\n\nexport const AI_SPEECH_AUDIO_PRIORITIES = [\n  \"critical\",\n  \"high\",\n  \"normal\",\n  \"low\",\n] as const;\n\nexport type AiSpeechAudioPriority =\n  (typeof AI_SPEECH_AUDIO_PRIORITIES)[number];\n\nexport const AI_SPEECH_AUDIO_DUCKING_MODES = [\n  \"none\",\n  \"music\",\n  \"non-critical\",\n  \"lower-priority\",\n] as const;\n\nexport type AiSpeechAudioDuckingMode =\n  (typeof AI_SPEECH_AUDIO_DUCKING_MODES)[number];\n\nexport const AI_SPEECH_AUDIO_CUE_FAMILIES = [\n  \"status\",\n  \"tutorial\",\n  \"mission\",\n  \"mcc\",\n  \"warning\",\n] as const;\n\nexport type AiSpeechAudioCueFamily =\n  (typeof AI_SPEECH_AUDIO_CUE_FAMILIES)[number];\n\nexport const AI_SPEECH_AUDIO_FOCUS_MODES = [\n  \"ambient\",\n  \"focused\",\n  \"combat-safe\",\n] as const;\n\nexport type AiSpeechAudioFocusMode =\n  (typeof AI_SPEECH_AUDIO_FOCUS_MODES)[number];\n\nexport const AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES = [\n  \"full\",\n  \"condensed\",\n  \"deferred\",\n  \"suppressed\",\n] as const;\n\nexport type AiSpeechAudioCombatSafeDelivery =\n  (typeof AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES)[number];\n\nexport interface AiSpeechAudioContractBase {\n  readonly id: string;\n  readonly featureFlagId: typeof AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID;\n  readonly priority: AiSpeechAudioPriority;\n  readonly ducking: AiSpeechAudioDuckingMode;\n  readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;\n}\n\nexport interface AiSpeechNarratedResponseContract\n  extends AiSpeechAudioContractBase {\n  readonly channel: \"narrated-response\";\n  readonly utteranceId: string;\n  readonly locale: string;\n}\n\nexport interface AiSpeechLocalizedCueContract extends AiSpeechAudioContractBase {\n  readonly channel: \"localized-cue\";\n  readonly cueFamily: AiSpeechAudioCueFamily;\n  readonly cueId: string;\n  readonly locale: string;\n}\n\nexport interface AiSpeechRepeatingWarningContract\n  extends AiSpeechAudioContractBase {\n  readonly channel: \"repeating-warning\";\n  readonly warningId: string;\n  readonly intervalSeconds: number;\n  readonly maximumOccurrencesPerMinute: number;\n}\n\nexport type AiSpeechAudioContract =\n  | AiSpeechNarratedResponseContract\n  | AiSpeechLocalizedCueContract\n  | AiSpeechRepeatingWarningContract;\n\nexport interface AiSpeechAudioContractBaseInput {\n  readonly id: string;\n  readonly priority: AiSpeechAudioPriority;\n  readonly ducking: AiSpeechAudioDuckingMode;\n  readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;\n}\n\nexport interface CreateAiSpeechNarratedResponseInput\n  extends AiSpeechAudioContractBaseInput {\n  readonly utteranceId: string;\n  readonly locale: string;\n}\n\nexport interface CreateAiSpeechLocalizedCueInput\n  extends AiSpeechAudioContractBaseInput {\n  readonly cueFamily: AiSpeechAudioCueFamily;\n  readonly cueId: string;\n  readonly locale: string;\n}\n\nexport interface CreateAiSpeechRepeatingWarningInput\n  extends AiSpeechAudioContractBaseInput {\n  readonly warningId: string;\n  readonly intervalSeconds: number;\n  readonly maximumOccurrencesPerMinute: number;\n}\n\nfunction requireAudioEnum<T extends string>(\n  value: T,\n  allowed: readonly T[],\n  label: string\n): T {\n  if (!allowed.includes(value)) {\n    throw new Error(`${label} is not supported: ${value}.`);\n  }\n\n  return value;\n}\n\nfunction requireBoundedAudioNumber(\n  value: number,\n  minimum: number,\n  maximum: number,\n  label: string\n): number {\n  if (!Number.isFinite(value) || value < minimum || value > maximum) {\n    throw new Error(\n      `${label} must be between ${minimum} and ${maximum}, inclusive.`\n    );\n  }\n\n  return value;\n}\n\nfunction createAiSpeechAudioContractBase(\n  input: AiSpeechAudioContractBaseInput\n): AiSpeechAudioContractBase {\n  return {\n    id: requireNonEmptyString(input.id, \"Audio contract id\"),\n    featureFlagId: AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,\n    priority: requireAudioEnum(\n      input.priority,\n      AI_SPEECH_AUDIO_PRIORITIES,\n      \"Audio priority\"\n    ),\n    ducking: requireAudioEnum(\n      input.ducking,\n      AI_SPEECH_AUDIO_DUCKING_MODES,\n      \"Audio ducking mode\"\n    ),\n    combatSafeDelivery: requireAudioEnum(\n      input.combatSafeDelivery,\n      AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,\n      \"Combat-safe audio delivery\"\n    ),\n  };\n}\n\nexport function createAiSpeechNarratedResponse(\n  input: CreateAiSpeechNarratedResponseInput\n): AiSpeechNarratedResponseContract {\n  return Object.freeze({\n    ...createAiSpeechAudioContractBase(input),\n    channel: \"narrated-response\" as const,\n    utteranceId: requireNonEmptyString(input.utteranceId, \"Utterance id\"),\n    locale: requireNonEmptyString(input.locale, \"Locale\"),\n  });\n}\n\nexport function createAiSpeechLocalizedCue(\n  input: CreateAiSpeechLocalizedCueInput\n): AiSpeechLocalizedCueContract {\n  return Object.freeze({\n    ...createAiSpeechAudioContractBase(input),\n    channel: \"localized-cue\" as const,\n    cueFamily: requireAudioEnum(\n      input.cueFamily,\n      AI_SPEECH_AUDIO_CUE_FAMILIES,\n      \"Audio cue family\"\n    ),\n    cueId: requireNonEmptyString(input.cueId, \"Cue id\"),\n    locale: requireNonEmptyString(input.locale, \"Locale\"),\n  });\n}\n\nexport function createAiSpeechRepeatingWarning(\n  input: CreateAiSpeechRepeatingWarningInput\n): AiSpeechRepeatingWarningContract {\n  return Object.freeze({\n    ...createAiSpeechAudioContractBase(input),\n    channel: \"repeating-warning\" as const,\n    warningId: requireNonEmptyString(input.warningId, \"Warning id\"),\n    intervalSeconds: requireBoundedAudioNumber(\n      input.intervalSeconds,\n      1,\n      3600,\n      \"Warning intervalSeconds\"\n    ),\n    maximumOccurrencesPerMinute: requireBoundedAudioNumber(\n      input.maximumOccurrencesPerMinute,\n      1,\n      60,\n      \"Warning maximumOccurrencesPerMinute\"\n    ),\n  });\n}\n\nexport interface ResolveAiSpeechAudioPolicyInput {\n  readonly contract: AiSpeechAudioContract;\n  readonly focusMode: AiSpeechAudioFocusMode;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n  readonly masterMuted?: boolean;\n  readonly userMuted?: boolean;\n  readonly activeContractIds?: readonly string[];\n}\n\nexport interface AiSpeechAudioPolicyDecision {\n  readonly deliver: boolean;\n  readonly mode: \"full\" | \"condensed\" | \"deferred\";\n  readonly ducking: AiSpeechAudioDuckingMode;\n  readonly reasonCodes: readonly string[];\n}\n\nfunction isPlayerSystemAudioEnabled(\n  featureFlags: AiSpeechFeatureFlagSnapshot = {}\n): boolean {\n  return featureFlags[AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID] === true;\n}\n\nexport function resolveAiSpeechAudioPolicy(\n  input: ResolveAiSpeechAudioPolicyInput\n): AiSpeechAudioPolicyDecision {\n  const { contract } = input;\n\n  if (!isPlayerSystemAudioEnabled(input.featureFlags)) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"player-system-audio-rollout-disabled\"],\n    };\n  }\n\n  if (input.masterMuted || input.userMuted) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [input.masterMuted ? \"master-muted\" : \"user-muted\"],\n    };\n  }\n\n  if (input.activeContractIds?.includes(contract.id)) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"duplicate-audio-contract-suppressed\"],\n    };\n  }\n\n  if (\n    input.focusMode === \"combat-safe\" &&\n    contract.priority !== \"critical\" &&\n    contract.priority !== \"high\"\n  ) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"combat-safe-priority-suppressed\"],\n    };\n  }\n\n  if (contract.combatSafeDelivery === \"suppressed\") {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"audio-contract-suppressed\"],\n    };\n  }\n\n  const mode =\n    input.focusMode === \"combat-safe\"\n      ? contract.combatSafeDelivery === \"condensed\"\n        ? \"condensed\"\n        : contract.combatSafeDelivery === \"deferred\"\n          ? \"deferred\"\n          : \"full\"\n      : \"full\";\n  const ducking = contract.priority === \"critical\" ? \"none\" : contract.ducking;\n\n  return {\n    deliver: mode !== \"deferred\",\n    mode,\n    ducking,\n    reasonCodes:\n      contract.priority === \"critical\"\n        ? [\"critical-priority-bypasses-ducking\"]\n        : [],\n  };\n}\n\nexport const packageDescriptor: AiPackageDescriptor = Object.freeze({\n  packageName: AI_SPEECH_PACKAGE,\n  featureFlagId: AI_SPEECH_FEATURE_FLAG_ID,\n  envPrefix: AI_SPEECH_ENV_PREFIX,\n  summary:\n    \"Speech orchestration, TTS cache contracts, STT/TTS routing, and voice tier policy for Plasius AI.\",\n});\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -145,6 +145,82 @@ declare function createAiSpeechCacheKey(input: AiSpeechCacheKeyInput): string;
 declare function createAiSpeechNearReuseFingerprint(value: string): string;
 declare function isAiSpeechNearReuseSafeClass(utteranceClass: AiSpeechUtteranceClass): boolean;
 declare function planAiSpeechCache(input: PlanAiSpeechCacheInput): AiSpeechCachePlan;
+declare const AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID: "isekai.player-system.audio.enabled";
+declare const AI_SPEECH_AUDIO_CHANNELS: readonly ["narrated-response", "localized-cue", "repeating-warning"];
+type AiSpeechAudioChannel = (typeof AI_SPEECH_AUDIO_CHANNELS)[number];
+declare const AI_SPEECH_AUDIO_PRIORITIES: readonly ["critical", "high", "normal", "low"];
+type AiSpeechAudioPriority = (typeof AI_SPEECH_AUDIO_PRIORITIES)[number];
+declare const AI_SPEECH_AUDIO_DUCKING_MODES: readonly ["none", "music", "non-critical", "lower-priority"];
+type AiSpeechAudioDuckingMode = (typeof AI_SPEECH_AUDIO_DUCKING_MODES)[number];
+declare const AI_SPEECH_AUDIO_CUE_FAMILIES: readonly ["status", "tutorial", "mission", "mcc", "warning"];
+type AiSpeechAudioCueFamily = (typeof AI_SPEECH_AUDIO_CUE_FAMILIES)[number];
+declare const AI_SPEECH_AUDIO_FOCUS_MODES: readonly ["ambient", "focused", "combat-safe"];
+type AiSpeechAudioFocusMode = (typeof AI_SPEECH_AUDIO_FOCUS_MODES)[number];
+declare const AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES: readonly ["full", "condensed", "deferred", "suppressed"];
+type AiSpeechAudioCombatSafeDelivery = (typeof AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES)[number];
+interface AiSpeechAudioContractBase {
+    readonly id: string;
+    readonly featureFlagId: typeof AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID;
+    readonly priority: AiSpeechAudioPriority;
+    readonly ducking: AiSpeechAudioDuckingMode;
+    readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;
+}
+interface AiSpeechNarratedResponseContract extends AiSpeechAudioContractBase {
+    readonly channel: "narrated-response";
+    readonly utteranceId: string;
+    readonly locale: string;
+}
+interface AiSpeechLocalizedCueContract extends AiSpeechAudioContractBase {
+    readonly channel: "localized-cue";
+    readonly cueFamily: AiSpeechAudioCueFamily;
+    readonly cueId: string;
+    readonly locale: string;
+}
+interface AiSpeechRepeatingWarningContract extends AiSpeechAudioContractBase {
+    readonly channel: "repeating-warning";
+    readonly warningId: string;
+    readonly intervalSeconds: number;
+    readonly maximumOccurrencesPerMinute: number;
+}
+type AiSpeechAudioContract = AiSpeechNarratedResponseContract | AiSpeechLocalizedCueContract | AiSpeechRepeatingWarningContract;
+interface AiSpeechAudioContractBaseInput {
+    readonly id: string;
+    readonly priority: AiSpeechAudioPriority;
+    readonly ducking: AiSpeechAudioDuckingMode;
+    readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;
+}
+interface CreateAiSpeechNarratedResponseInput extends AiSpeechAudioContractBaseInput {
+    readonly utteranceId: string;
+    readonly locale: string;
+}
+interface CreateAiSpeechLocalizedCueInput extends AiSpeechAudioContractBaseInput {
+    readonly cueFamily: AiSpeechAudioCueFamily;
+    readonly cueId: string;
+    readonly locale: string;
+}
+interface CreateAiSpeechRepeatingWarningInput extends AiSpeechAudioContractBaseInput {
+    readonly warningId: string;
+    readonly intervalSeconds: number;
+    readonly maximumOccurrencesPerMinute: number;
+}
+declare function createAiSpeechNarratedResponse(input: CreateAiSpeechNarratedResponseInput): AiSpeechNarratedResponseContract;
+declare function createAiSpeechLocalizedCue(input: CreateAiSpeechLocalizedCueInput): AiSpeechLocalizedCueContract;
+declare function createAiSpeechRepeatingWarning(input: CreateAiSpeechRepeatingWarningInput): AiSpeechRepeatingWarningContract;
+interface ResolveAiSpeechAudioPolicyInput {
+    readonly contract: AiSpeechAudioContract;
+    readonly focusMode: AiSpeechAudioFocusMode;
+    readonly featureFlags?: AiSpeechFeatureFlagSnapshot;
+    readonly masterMuted?: boolean;
+    readonly userMuted?: boolean;
+    readonly activeContractIds?: readonly string[];
+}
+interface AiSpeechAudioPolicyDecision {
+    readonly deliver: boolean;
+    readonly mode: "full" | "condensed" | "deferred";
+    readonly ducking: AiSpeechAudioDuckingMode;
+    readonly reasonCodes: readonly string[];
+}
+declare function resolveAiSpeechAudioPolicy(input: ResolveAiSpeechAudioPolicyInput): AiSpeechAudioPolicyDecision;
 declare const packageDescriptor: AiPackageDescriptor;
 
-export { AI_SPEECH_CACHE_MODES, AI_SPEECH_CACHE_SCOPES, AI_SPEECH_DEFAULT_PLAYER_LABEL, AI_SPEECH_ENVIRONMENTS, AI_SPEECH_ENV_PREFIX, AI_SPEECH_FEATURE_FLAGS, AI_SPEECH_FEATURE_FLAG_ID, AI_SPEECH_NEAR_REUSE_SAFE_CLASSES, AI_SPEECH_PACKAGE, AI_SPEECH_PLAYER_ADDRESS_SOURCES, AI_SPEECH_PROVIDER_CACHE_PERMISSIONS, AI_SPEECH_ROLLOUTS, AI_SPEECH_ROLLOUT_EVALUATORS, AI_SPEECH_ROLLOUT_FALLBACK_MODES, AI_SPEECH_UTTERANCE_CLASSES, AI_SPEECH_VOICE_TIERS, type AiPackageDescriptor, type AiSpeechCacheKeyInput, type AiSpeechCacheMode, type AiSpeechCachePlan, type AiSpeechCacheScope, type AiSpeechCacheTelemetry, type AiSpeechEnvironment, type AiSpeechFeatureFlagKey, type AiSpeechFeatureFlagSnapshot, type AiSpeechPlayerAddressDecision, type AiSpeechPlayerAddressInput, type AiSpeechPlayerAddressSource, type AiSpeechProviderCachePermission, type AiSpeechRenderTextInput, type AiSpeechRenderTextResult, type AiSpeechRolloutControl, type AiSpeechRolloutDecision, type AiSpeechRolloutEvaluator, type AiSpeechRolloutFallbackMode, type AiSpeechUtteranceClass, type AiSpeechVoiceProfileRef, type AiSpeechVoiceTier, type AiSpeechVoiceTierDecision, type PlanAiSpeechCacheInput, type ResolveAiSpeechVoiceTierInput, createAiSpeechCacheKey, createAiSpeechNearReuseFingerprint, isAiSpeechFeatureEnabled, isAiSpeechNearReuseSafeClass, normalizeAiSpeechText, packageDescriptor, planAiSpeechCache, renderAiSpeechText, resolveAiSpeechPlayerAddress, resolveAiSpeechRolloutDecision, resolveAiSpeechVoiceTier };
+export { AI_SPEECH_AUDIO_CHANNELS, AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES, AI_SPEECH_AUDIO_CUE_FAMILIES, AI_SPEECH_AUDIO_DUCKING_MODES, AI_SPEECH_AUDIO_FOCUS_MODES, AI_SPEECH_AUDIO_PRIORITIES, AI_SPEECH_CACHE_MODES, AI_SPEECH_CACHE_SCOPES, AI_SPEECH_DEFAULT_PLAYER_LABEL, AI_SPEECH_ENVIRONMENTS, AI_SPEECH_ENV_PREFIX, AI_SPEECH_FEATURE_FLAGS, AI_SPEECH_FEATURE_FLAG_ID, AI_SPEECH_NEAR_REUSE_SAFE_CLASSES, AI_SPEECH_PACKAGE, AI_SPEECH_PLAYER_ADDRESS_SOURCES, AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID, AI_SPEECH_PROVIDER_CACHE_PERMISSIONS, AI_SPEECH_ROLLOUTS, AI_SPEECH_ROLLOUT_EVALUATORS, AI_SPEECH_ROLLOUT_FALLBACK_MODES, AI_SPEECH_UTTERANCE_CLASSES, AI_SPEECH_VOICE_TIERS, type AiPackageDescriptor, type AiSpeechAudioChannel, type AiSpeechAudioCombatSafeDelivery, type AiSpeechAudioContract, type AiSpeechAudioContractBase, type AiSpeechAudioContractBaseInput, type AiSpeechAudioCueFamily, type AiSpeechAudioDuckingMode, type AiSpeechAudioFocusMode, type AiSpeechAudioPolicyDecision, type AiSpeechAudioPriority, type AiSpeechCacheKeyInput, type AiSpeechCacheMode, type AiSpeechCachePlan, type AiSpeechCacheScope, type AiSpeechCacheTelemetry, type AiSpeechEnvironment, type AiSpeechFeatureFlagKey, type AiSpeechFeatureFlagSnapshot, type AiSpeechLocalizedCueContract, type AiSpeechNarratedResponseContract, type AiSpeechPlayerAddressDecision, type AiSpeechPlayerAddressInput, type AiSpeechPlayerAddressSource, type AiSpeechProviderCachePermission, type AiSpeechRenderTextInput, type AiSpeechRenderTextResult, type AiSpeechRepeatingWarningContract, type AiSpeechRolloutControl, type AiSpeechRolloutDecision, type AiSpeechRolloutEvaluator, type AiSpeechRolloutFallbackMode, type AiSpeechUtteranceClass, type AiSpeechVoiceProfileRef, type AiSpeechVoiceTier, type AiSpeechVoiceTierDecision, type CreateAiSpeechLocalizedCueInput, type CreateAiSpeechNarratedResponseInput, type CreateAiSpeechRepeatingWarningInput, type PlanAiSpeechCacheInput, type ResolveAiSpeechAudioPolicyInput, type ResolveAiSpeechVoiceTierInput, createAiSpeechCacheKey, createAiSpeechLocalizedCue, createAiSpeechNarratedResponse, createAiSpeechNearReuseFingerprint, createAiSpeechRepeatingWarning, isAiSpeechFeatureEnabled, isAiSpeechNearReuseSafeClass, normalizeAiSpeechText, packageDescriptor, planAiSpeechCache, renderAiSpeechText, resolveAiSpeechAudioPolicy, resolveAiSpeechPlayerAddress, resolveAiSpeechRolloutDecision, resolveAiSpeechVoiceTier };

package/dist/index.d.ts

@@ -145,6 +145,82 @@ declare function createAiSpeechCacheKey(input: AiSpeechCacheKeyInput): string;
 declare function createAiSpeechNearReuseFingerprint(value: string): string;
 declare function isAiSpeechNearReuseSafeClass(utteranceClass: AiSpeechUtteranceClass): boolean;
 declare function planAiSpeechCache(input: PlanAiSpeechCacheInput): AiSpeechCachePlan;
+declare const AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID: "isekai.player-system.audio.enabled";
+declare const AI_SPEECH_AUDIO_CHANNELS: readonly ["narrated-response", "localized-cue", "repeating-warning"];
+type AiSpeechAudioChannel = (typeof AI_SPEECH_AUDIO_CHANNELS)[number];
+declare const AI_SPEECH_AUDIO_PRIORITIES: readonly ["critical", "high", "normal", "low"];
+type AiSpeechAudioPriority = (typeof AI_SPEECH_AUDIO_PRIORITIES)[number];
+declare const AI_SPEECH_AUDIO_DUCKING_MODES: readonly ["none", "music", "non-critical", "lower-priority"];
+type AiSpeechAudioDuckingMode = (typeof AI_SPEECH_AUDIO_DUCKING_MODES)[number];
+declare const AI_SPEECH_AUDIO_CUE_FAMILIES: readonly ["status", "tutorial", "mission", "mcc", "warning"];
+type AiSpeechAudioCueFamily = (typeof AI_SPEECH_AUDIO_CUE_FAMILIES)[number];
+declare const AI_SPEECH_AUDIO_FOCUS_MODES: readonly ["ambient", "focused", "combat-safe"];
+type AiSpeechAudioFocusMode = (typeof AI_SPEECH_AUDIO_FOCUS_MODES)[number];
+declare const AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES: readonly ["full", "condensed", "deferred", "suppressed"];
+type AiSpeechAudioCombatSafeDelivery = (typeof AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES)[number];
+interface AiSpeechAudioContractBase {
+    readonly id: string;
+    readonly featureFlagId: typeof AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID;
+    readonly priority: AiSpeechAudioPriority;
+    readonly ducking: AiSpeechAudioDuckingMode;
+    readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;
+}
+interface AiSpeechNarratedResponseContract extends AiSpeechAudioContractBase {
+    readonly channel: "narrated-response";
+    readonly utteranceId: string;
+    readonly locale: string;
+}
+interface AiSpeechLocalizedCueContract extends AiSpeechAudioContractBase {
+    readonly channel: "localized-cue";
+    readonly cueFamily: AiSpeechAudioCueFamily;
+    readonly cueId: string;
+    readonly locale: string;
+}
+interface AiSpeechRepeatingWarningContract extends AiSpeechAudioContractBase {
+    readonly channel: "repeating-warning";
+    readonly warningId: string;
+    readonly intervalSeconds: number;
+    readonly maximumOccurrencesPerMinute: number;
+}
+type AiSpeechAudioContract = AiSpeechNarratedResponseContract | AiSpeechLocalizedCueContract | AiSpeechRepeatingWarningContract;
+interface AiSpeechAudioContractBaseInput {
+    readonly id: string;
+    readonly priority: AiSpeechAudioPriority;
+    readonly ducking: AiSpeechAudioDuckingMode;
+    readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;
+}
+interface CreateAiSpeechNarratedResponseInput extends AiSpeechAudioContractBaseInput {
+    readonly utteranceId: string;
+    readonly locale: string;
+}
+interface CreateAiSpeechLocalizedCueInput extends AiSpeechAudioContractBaseInput {
+    readonly cueFamily: AiSpeechAudioCueFamily;
+    readonly cueId: string;
+    readonly locale: string;
+}
+interface CreateAiSpeechRepeatingWarningInput extends AiSpeechAudioContractBaseInput {
+    readonly warningId: string;
+    readonly intervalSeconds: number;
+    readonly maximumOccurrencesPerMinute: number;
+}
+declare function createAiSpeechNarratedResponse(input: CreateAiSpeechNarratedResponseInput): AiSpeechNarratedResponseContract;
+declare function createAiSpeechLocalizedCue(input: CreateAiSpeechLocalizedCueInput): AiSpeechLocalizedCueContract;
+declare function createAiSpeechRepeatingWarning(input: CreateAiSpeechRepeatingWarningInput): AiSpeechRepeatingWarningContract;
+interface ResolveAiSpeechAudioPolicyInput {
+    readonly contract: AiSpeechAudioContract;
+    readonly focusMode: AiSpeechAudioFocusMode;
+    readonly featureFlags?: AiSpeechFeatureFlagSnapshot;
+    readonly masterMuted?: boolean;
+    readonly userMuted?: boolean;
+    readonly activeContractIds?: readonly string[];
+}
+interface AiSpeechAudioPolicyDecision {
+    readonly deliver: boolean;
+    readonly mode: "full" | "condensed" | "deferred";
+    readonly ducking: AiSpeechAudioDuckingMode;
+    readonly reasonCodes: readonly string[];
+}
+declare function resolveAiSpeechAudioPolicy(input: ResolveAiSpeechAudioPolicyInput): AiSpeechAudioPolicyDecision;
 declare const packageDescriptor: AiPackageDescriptor;
 
-export { AI_SPEECH_CACHE_MODES, AI_SPEECH_CACHE_SCOPES, AI_SPEECH_DEFAULT_PLAYER_LABEL, AI_SPEECH_ENVIRONMENTS, AI_SPEECH_ENV_PREFIX, AI_SPEECH_FEATURE_FLAGS, AI_SPEECH_FEATURE_FLAG_ID, AI_SPEECH_NEAR_REUSE_SAFE_CLASSES, AI_SPEECH_PACKAGE, AI_SPEECH_PLAYER_ADDRESS_SOURCES, AI_SPEECH_PROVIDER_CACHE_PERMISSIONS, AI_SPEECH_ROLLOUTS, AI_SPEECH_ROLLOUT_EVALUATORS, AI_SPEECH_ROLLOUT_FALLBACK_MODES, AI_SPEECH_UTTERANCE_CLASSES, AI_SPEECH_VOICE_TIERS, type AiPackageDescriptor, type AiSpeechCacheKeyInput, type AiSpeechCacheMode, type AiSpeechCachePlan, type AiSpeechCacheScope, type AiSpeechCacheTelemetry, type AiSpeechEnvironment, type AiSpeechFeatureFlagKey, type AiSpeechFeatureFlagSnapshot, type AiSpeechPlayerAddressDecision, type AiSpeechPlayerAddressInput, type AiSpeechPlayerAddressSource, type AiSpeechProviderCachePermission, type AiSpeechRenderTextInput, type AiSpeechRenderTextResult, type AiSpeechRolloutControl, type AiSpeechRolloutDecision, type AiSpeechRolloutEvaluator, type AiSpeechRolloutFallbackMode, type AiSpeechUtteranceClass, type AiSpeechVoiceProfileRef, type AiSpeechVoiceTier, type AiSpeechVoiceTierDecision, type PlanAiSpeechCacheInput, type ResolveAiSpeechVoiceTierInput, createAiSpeechCacheKey, createAiSpeechNearReuseFingerprint, isAiSpeechFeatureEnabled, isAiSpeechNearReuseSafeClass, normalizeAiSpeechText, packageDescriptor, planAiSpeechCache, renderAiSpeechText, resolveAiSpeechPlayerAddress, resolveAiSpeechRolloutDecision, resolveAiSpeechVoiceTier };
+export { AI_SPEECH_AUDIO_CHANNELS, AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES, AI_SPEECH_AUDIO_CUE_FAMILIES, AI_SPEECH_AUDIO_DUCKING_MODES, AI_SPEECH_AUDIO_FOCUS_MODES, AI_SPEECH_AUDIO_PRIORITIES, AI_SPEECH_CACHE_MODES, AI_SPEECH_CACHE_SCOPES, AI_SPEECH_DEFAULT_PLAYER_LABEL, AI_SPEECH_ENVIRONMENTS, AI_SPEECH_ENV_PREFIX, AI_SPEECH_FEATURE_FLAGS, AI_SPEECH_FEATURE_FLAG_ID, AI_SPEECH_NEAR_REUSE_SAFE_CLASSES, AI_SPEECH_PACKAGE, AI_SPEECH_PLAYER_ADDRESS_SOURCES, AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID, AI_SPEECH_PROVIDER_CACHE_PERMISSIONS, AI_SPEECH_ROLLOUTS, AI_SPEECH_ROLLOUT_EVALUATORS, AI_SPEECH_ROLLOUT_FALLBACK_MODES, AI_SPEECH_UTTERANCE_CLASSES, AI_SPEECH_VOICE_TIERS, type AiPackageDescriptor, type AiSpeechAudioChannel, type AiSpeechAudioCombatSafeDelivery, type AiSpeechAudioContract, type AiSpeechAudioContractBase, type AiSpeechAudioContractBaseInput, type AiSpeechAudioCueFamily, type AiSpeechAudioDuckingMode, type AiSpeechAudioFocusMode, type AiSpeechAudioPolicyDecision, type AiSpeechAudioPriority, type AiSpeechCacheKeyInput, type AiSpeechCacheMode, type AiSpeechCachePlan, type AiSpeechCacheScope, type AiSpeechCacheTelemetry, type AiSpeechEnvironment, type AiSpeechFeatureFlagKey, type AiSpeechFeatureFlagSnapshot, type AiSpeechLocalizedCueContract, type AiSpeechNarratedResponseContract, type AiSpeechPlayerAddressDecision, type AiSpeechPlayerAddressInput, type AiSpeechPlayerAddressSource, type AiSpeechProviderCachePermission, type AiSpeechRenderTextInput, type AiSpeechRenderTextResult, type AiSpeechRepeatingWarningContract, type AiSpeechRolloutControl, type AiSpeechRolloutDecision, type AiSpeechRolloutEvaluator, type AiSpeechRolloutFallbackMode, type AiSpeechUtteranceClass, type AiSpeechVoiceProfileRef, type AiSpeechVoiceTier, type AiSpeechVoiceTierDecision, type CreateAiSpeechLocalizedCueInput, type CreateAiSpeechNarratedResponseInput, type CreateAiSpeechRepeatingWarningInput, type PlanAiSpeechCacheInput, type ResolveAiSpeechAudioPolicyInput, type ResolveAiSpeechVoiceTierInput, createAiSpeechCacheKey, createAiSpeechLocalizedCue, createAiSpeechNarratedResponse, createAiSpeechNearReuseFingerprint, createAiSpeechRepeatingWarning, isAiSpeechFeatureEnabled, isAiSpeechNearReuseSafeClass, normalizeAiSpeechText, packageDescriptor, planAiSpeechCache, renderAiSpeechText, resolveAiSpeechAudioPolicy, resolveAiSpeechPlayerAddress, resolveAiSpeechRolloutDecision, resolveAiSpeechVoiceTier };

package/dist/index.js

@@ -327,6 +327,171 @@ function planAiSpeechCache(input) {
     reasonCodes: ["near-reuse-eligible"]
   };
 }
+var AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID = "isekai.player-system.audio.enabled";
+var AI_SPEECH_AUDIO_CHANNELS = [
+  "narrated-response",
+  "localized-cue",
+  "repeating-warning"
+];
+var AI_SPEECH_AUDIO_PRIORITIES = [
+  "critical",
+  "high",
+  "normal",
+  "low"
+];
+var AI_SPEECH_AUDIO_DUCKING_MODES = [
+  "none",
+  "music",
+  "non-critical",
+  "lower-priority"
+];
+var AI_SPEECH_AUDIO_CUE_FAMILIES = [
+  "status",
+  "tutorial",
+  "mission",
+  "mcc",
+  "warning"
+];
+var AI_SPEECH_AUDIO_FOCUS_MODES = [
+  "ambient",
+  "focused",
+  "combat-safe"
+];
+var AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES = [
+  "full",
+  "condensed",
+  "deferred",
+  "suppressed"
+];
+function requireAudioEnum(value, allowed, label) {
+  if (!allowed.includes(value)) {
+    throw new Error(`${label} is not supported: ${value}.`);
+  }
+  return value;
+}
+function requireBoundedAudioNumber(value, minimum, maximum, label) {
+  if (!Number.isFinite(value) || value < minimum || value > maximum) {
+    throw new Error(
+      `${label} must be between ${minimum} and ${maximum}, inclusive.`
+    );
+  }
+  return value;
+}
+function createAiSpeechAudioContractBase(input) {
+  return {
+    id: requireNonEmptyString(input.id, "Audio contract id"),
+    featureFlagId: AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,
+    priority: requireAudioEnum(
+      input.priority,
+      AI_SPEECH_AUDIO_PRIORITIES,
+      "Audio priority"
+    ),
+    ducking: requireAudioEnum(
+      input.ducking,
+      AI_SPEECH_AUDIO_DUCKING_MODES,
+      "Audio ducking mode"
+    ),
+    combatSafeDelivery: requireAudioEnum(
+      input.combatSafeDelivery,
+      AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,
+      "Combat-safe audio delivery"
+    )
+  };
+}
+function createAiSpeechNarratedResponse(input) {
+  return Object.freeze({
+    ...createAiSpeechAudioContractBase(input),
+    channel: "narrated-response",
+    utteranceId: requireNonEmptyString(input.utteranceId, "Utterance id"),
+    locale: requireNonEmptyString(input.locale, "Locale")
+  });
+}
+function createAiSpeechLocalizedCue(input) {
+  return Object.freeze({
+    ...createAiSpeechAudioContractBase(input),
+    channel: "localized-cue",
+    cueFamily: requireAudioEnum(
+      input.cueFamily,
+      AI_SPEECH_AUDIO_CUE_FAMILIES,
+      "Audio cue family"
+    ),
+    cueId: requireNonEmptyString(input.cueId, "Cue id"),
+    locale: requireNonEmptyString(input.locale, "Locale")
+  });
+}
+function createAiSpeechRepeatingWarning(input) {
+  return Object.freeze({
+    ...createAiSpeechAudioContractBase(input),
+    channel: "repeating-warning",
+    warningId: requireNonEmptyString(input.warningId, "Warning id"),
+    intervalSeconds: requireBoundedAudioNumber(
+      input.intervalSeconds,
+      1,
+      3600,
+      "Warning intervalSeconds"
+    ),
+    maximumOccurrencesPerMinute: requireBoundedAudioNumber(
+      input.maximumOccurrencesPerMinute,
+      1,
+      60,
+      "Warning maximumOccurrencesPerMinute"
+    )
+  });
+}
+function isPlayerSystemAudioEnabled(featureFlags = {}) {
+  return featureFlags[AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID] === true;
+}
+function resolveAiSpeechAudioPolicy(input) {
+  const { contract } = input;
+  if (!isPlayerSystemAudioEnabled(input.featureFlags)) {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["player-system-audio-rollout-disabled"]
+    };
+  }
+  if (input.masterMuted || input.userMuted) {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: [input.masterMuted ? "master-muted" : "user-muted"]
+    };
+  }
+  if (input.activeContractIds?.includes(contract.id)) {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["duplicate-audio-contract-suppressed"]
+    };
+  }
+  if (input.focusMode === "combat-safe" && contract.priority !== "critical" && contract.priority !== "high") {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["combat-safe-priority-suppressed"]
+    };
+  }
+  if (contract.combatSafeDelivery === "suppressed") {
+    return {
+      deliver: false,
+      mode: "deferred",
+      ducking: "none",
+      reasonCodes: ["audio-contract-suppressed"]
+    };
+  }
+  const mode = input.focusMode === "combat-safe" ? contract.combatSafeDelivery === "condensed" ? "condensed" : contract.combatSafeDelivery === "deferred" ? "deferred" : "full" : "full";
+  const ducking = contract.priority === "critical" ? "none" : contract.ducking;
+  return {
+    deliver: mode !== "deferred",
+    mode,
+    ducking,
+    reasonCodes: contract.priority === "critical" ? ["critical-priority-bypasses-ducking"] : []
+  };
+}
 var packageDescriptor = Object.freeze({
   packageName: AI_SPEECH_PACKAGE,
   featureFlagId: AI_SPEECH_FEATURE_FLAG_ID,
@@ -334,6 +499,12 @@ var packageDescriptor = Object.freeze({
   summary: "Speech orchestration, TTS cache contracts, STT/TTS routing, and voice tier policy for Plasius AI."
 });
 export {
+  AI_SPEECH_AUDIO_CHANNELS,
+  AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,
+  AI_SPEECH_AUDIO_CUE_FAMILIES,
+  AI_SPEECH_AUDIO_DUCKING_MODES,
+  AI_SPEECH_AUDIO_FOCUS_MODES,
+  AI_SPEECH_AUDIO_PRIORITIES,
   AI_SPEECH_CACHE_MODES,
   AI_SPEECH_CACHE_SCOPES,
   AI_SPEECH_DEFAULT_PLAYER_LABEL,
@@ -344,6 +515,7 @@ export {
   AI_SPEECH_NEAR_REUSE_SAFE_CLASSES,
   AI_SPEECH_PACKAGE,
   AI_SPEECH_PLAYER_ADDRESS_SOURCES,
+  AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,
   AI_SPEECH_PROVIDER_CACHE_PERMISSIONS,
   AI_SPEECH_ROLLOUTS,
   AI_SPEECH_ROLLOUT_EVALUATORS,
@@ -351,13 +523,17 @@ export {
   AI_SPEECH_UTTERANCE_CLASSES,
   AI_SPEECH_VOICE_TIERS,
   createAiSpeechCacheKey,
+  createAiSpeechLocalizedCue,
+  createAiSpeechNarratedResponse,
   createAiSpeechNearReuseFingerprint,
+  createAiSpeechRepeatingWarning,
   isAiSpeechFeatureEnabled,
   isAiSpeechNearReuseSafeClass,
   normalizeAiSpeechText,
   packageDescriptor,
   planAiSpeechCache,
   renderAiSpeechText,
+  resolveAiSpeechAudioPolicy,
   resolveAiSpeechPlayerAddress,
   resolveAiSpeechRolloutDecision,
   resolveAiSpeechVoiceTier

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface AiPackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nfunction requireNonEmptyString(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new Error(`${label} must be a non-empty string.`);\n  }\n\n  return trimmed;\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/gu, \" \").trim();\n}\n\nexport const AI_SPEECH_PACKAGE = \"@plasius/ai-speech\";\nexport const AI_SPEECH_ENV_PREFIX = \"AI_SPEECH\";\n\nexport const AI_SPEECH_FEATURE_FLAGS = {\n  ttsCache: \"ai.tts.cache.enabled\",\n  ttsNearReuse: \"ai.tts.near-reuse.enabled\",\n  premiumCharacters: \"ai.tts.premium-characters.enabled\",\n} as const;\n\nexport type AiSpeechFeatureFlagKey =\n  (typeof AI_SPEECH_FEATURE_FLAGS)[keyof typeof AI_SPEECH_FEATURE_FLAGS];\n\nexport type AiSpeechFeatureFlagSnapshot = Readonly<\n  Record<string, boolean | undefined>\n>;\n\nexport const AI_SPEECH_FEATURE_FLAG_ID = AI_SPEECH_FEATURE_FLAGS.ttsCache;\n\nexport const AI_SPEECH_ROLLOUT_EVALUATORS = [\n  \"remote-flag-service\",\n  \"host-application\",\n  \"break-glass-env\",\n] as const;\n\nexport type AiSpeechRolloutEvaluator =\n  (typeof AI_SPEECH_ROLLOUT_EVALUATORS)[number];\n\nexport const AI_SPEECH_ROLLOUT_FALLBACK_MODES = [\n  \"fail-closed\",\n  \"fail-open\",\n] as const;\n\nexport type AiSpeechRolloutFallbackMode =\n  (typeof AI_SPEECH_ROLLOUT_FALLBACK_MODES)[number];\n\nexport interface AiSpeechRolloutControl {\n  readonly featureFlag: AiSpeechFeatureFlagKey;\n  readonly evaluator: AiSpeechRolloutEvaluator;\n  readonly defaultEnabled: boolean;\n  readonly fallbackMode: AiSpeechRolloutFallbackMode;\n}\n\nexport interface AiSpeechRolloutDecision extends AiSpeechRolloutControl {\n  readonly enabled: boolean;\n  readonly source: \"snapshot\" | \"default\";\n}\n\nexport const AI_SPEECH_ROLLOUTS = Object.freeze({\n  ttsCache: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  ttsNearReuse: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  premiumCharacters: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n});\n\nexport function resolveAiSpeechRolloutDecision(\n  control: AiSpeechRolloutControl,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): AiSpeechRolloutDecision {\n  const resolved = snapshot[control.featureFlag];\n  if (typeof resolved === \"boolean\") {\n    return {\n      ...control,\n      enabled: resolved,\n      source: \"snapshot\",\n    };\n  }\n\n  return {\n    ...control,\n    enabled: control.defaultEnabled,\n    source: \"default\",\n  };\n}\n\nexport function isAiSpeechFeatureEnabled(\n  featureFlag: AiSpeechFeatureFlagKey,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): boolean {\n  const control = Object.values(AI_SPEECH_ROLLOUTS).find(\n    (candidate) => candidate.featureFlag === featureFlag\n  );\n\n  if (!control) {\n    return false;\n  }\n\n  return resolveAiSpeechRolloutDecision(control, snapshot).enabled;\n}\n\nexport const AI_SPEECH_VOICE_TIERS = [\n  \"development\",\n  \"standard\",\n  \"premium-character\",\n] as const;\n\nexport type AiSpeechVoiceTier = (typeof AI_SPEECH_VOICE_TIERS)[number];\n\nexport const AI_SPEECH_ENVIRONMENTS = [\n  \"development\",\n  \"preview\",\n  \"production\",\n] as const;\n\nexport type AiSpeechEnvironment = (typeof AI_SPEECH_ENVIRONMENTS)[number];\n\nexport interface AiSpeechVoiceTierDecision {\n  readonly requestedTier: AiSpeechVoiceTier;\n  readonly resolvedTier: AiSpeechVoiceTier;\n  readonly fallbackTier?: AiSpeechVoiceTier;\n  readonly reasonCodes: readonly string[];\n}\n\nexport interface ResolveAiSpeechVoiceTierInput {\n  readonly environment: AiSpeechEnvironment;\n  readonly requestedTier?: AiSpeechVoiceTier;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n}\n\nexport function resolveAiSpeechVoiceTier(\n  input: ResolveAiSpeechVoiceTierInput\n): AiSpeechVoiceTierDecision {\n  const requestedTier =\n    input.requestedTier ??\n    (input.environment === \"development\" ? \"development\" : \"standard\");\n\n  if (\n    requestedTier === \"premium-character\" &&\n    !isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n      input.featureFlags\n    )\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"premium-character-rollout-disabled\"],\n    };\n  }\n\n  if (\n    requestedTier === \"development\" &&\n    input.environment !== \"development\"\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"development-voices-limited-to-development-environments\"],\n    };\n  }\n\n  return {\n    requestedTier,\n    resolvedTier: requestedTier,\n    reasonCodes: [],\n  };\n}\n\nexport const AI_SPEECH_PLAYER_ADDRESS_SOURCES = [\n  \"generic-player\",\n  \"class-title\",\n  \"faction-title\",\n  \"authored-character\",\n  \"user-name\",\n  \"account-handle\",\n  \"user-renamed-character\",\n] as const;\n\nexport type AiSpeechPlayerAddressSource =\n  (typeof AI_SPEECH_PLAYER_ADDRESS_SOURCES)[number];\n\nexport const AI_SPEECH_DEFAULT_PLAYER_LABEL = \"Player\";\n\nexport interface AiSpeechPlayerAddressInput {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly rawValue?: string;\n  readonly fallbackLabel?: string;\n}\n\nexport interface AiSpeechPlayerAddressDecision {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly renderText: string;\n  readonly exactReuseAllowed: boolean;\n  readonly nearReuseAllowed: boolean;\n  readonly redacted: boolean;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function resolveAiSpeechPlayerAddress(\n  input: AiSpeechPlayerAddressInput\n): AiSpeechPlayerAddressDecision {\n  const fallbackLabel =\n    normalizeWhitespace(input.fallbackLabel ?? \"\") ||\n    AI_SPEECH_DEFAULT_PLAYER_LABEL;\n  const rawValue = normalizeWhitespace(input.rawValue ?? \"\");\n\n  switch (input.source) {\n    case \"generic-player\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: [\"generic-player-address\"],\n      };\n    case \"class-title\":\n    case \"faction-title\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"authored-character\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"user-name\":\n    case \"account-handle\":\n    case \"user-renamed-character\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: false,\n        redacted: true,\n        reasonCodes: [\"player-identifier-redacted-from-render-text\"],\n      };\n  }\n}\n\nexport interface AiSpeechRenderTextInput {\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n}\n\nexport interface AiSpeechRenderTextResult {\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n}\n\nexport function renderAiSpeechText(\n  input: AiSpeechRenderTextInput\n): AiSpeechRenderTextResult {\n  const textTemplate = requireNonEmptyString(\n    input.textTemplate,\n    \"Speech text template\"\n  );\n  const hasPlayerPlaceholder = textTemplate.includes(\"{playerAddress}\");\n\n  if (hasPlayerPlaceholder && !input.playerAddress) {\n    throw new Error(\n      \"Speech text template requires playerAddress when using the {playerAddress} placeholder.\"\n    );\n  }\n\n  const playerAddress = input.playerAddress\n    ? resolveAiSpeechPlayerAddress(input.playerAddress)\n    : undefined;\n  const renderText = normalizeWhitespace(\n    hasPlayerPlaceholder && playerAddress\n      ? textTemplate.replace(/\\{playerAddress\\}/gu, playerAddress.renderText)\n      : textTemplate\n  );\n\n  return {\n    renderText,\n    normalizedRenderText: normalizeAiSpeechText(renderText),\n    playerAddress,\n  };\n}\n\nexport function normalizeAiSpeechText(value: string): string {\n  return requireNonEmptyString(\n    normalizeWhitespace(value).toLocaleLowerCase(\"en-GB\"),\n    \"Speech text\"\n  );\n}\n\nexport const AI_SPEECH_PROVIDER_CACHE_PERMISSIONS = [\n  \"forbidden\",\n  \"exact-only\",\n  \"exact-and-near\",\n] as const;\n\nexport type AiSpeechProviderCachePermission =\n  (typeof AI_SPEECH_PROVIDER_CACHE_PERMISSIONS)[number];\n\nexport const AI_SPEECH_CACHE_MODES = [\n  \"disabled\",\n  \"no-cache\",\n  \"exact\",\n  \"near\",\n] as const;\n\nexport type AiSpeechCacheMode = (typeof AI_SPEECH_CACHE_MODES)[number];\n\nexport const AI_SPEECH_CACHE_SCOPES = [\"none\", \"actor\", \"global\"] as const;\n\nexport type AiSpeechCacheScope = (typeof AI_SPEECH_CACHE_SCOPES)[number];\n\nexport const AI_SPEECH_UTTERANCE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n  \"moderation-notice\",\n  \"private-response\",\n] as const;\n\nexport type AiSpeechUtteranceClass =\n  (typeof AI_SPEECH_UTTERANCE_CLASSES)[number];\n\nexport const AI_SPEECH_NEAR_REUSE_SAFE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n] as const satisfies readonly AiSpeechUtteranceClass[];\n\nconst AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET: ReadonlySet<AiSpeechUtteranceClass> =\n  new Set(AI_SPEECH_NEAR_REUSE_SAFE_CLASSES);\n\nexport interface AiSpeechCacheKeyInput {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly normalizedRenderText: string;\n  readonly styleId?: string;\n  readonly scopeDiscriminator?: string;\n}\n\nexport interface AiSpeechVoiceProfileRef {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly styleId?: string;\n  readonly cachePermission: AiSpeechProviderCachePermission;\n  readonly tier?: AiSpeechVoiceTier;\n  readonly profileId?: string;\n}\n\nexport interface AiSpeechCacheTelemetry {\n  readonly cacheHits: number;\n  readonly nearCacheHits: number;\n  readonly cacheMisses: number;\n  readonly charactersSaved: number;\n  readonly estimatedCostSavedUsd?: number;\n  readonly voiceProfileIds?: readonly string[];\n}\n\nexport interface PlanAiSpeechCacheInput {\n  readonly utteranceClass: AiSpeechUtteranceClass;\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n  readonly voice: AiSpeechVoiceProfileRef;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n  readonly actorScopeKey?: string;\n  readonly containsPersonalData?: boolean;\n  readonly containsPrivateContext?: boolean;\n  readonly containsModerationNotice?: boolean;\n}\n\nexport interface AiSpeechCachePlan {\n  readonly mode: AiSpeechCacheMode;\n  readonly sharingScope: AiSpeechCacheScope;\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly exactKey?: string;\n  readonly nearKey?: string;\n  readonly enabledFeatureFlags: readonly AiSpeechFeatureFlagKey[];\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function createAiSpeechCacheKey(input: AiSpeechCacheKeyInput): string {\n  const scopeDiscriminator = normalizeWhitespace(input.scopeDiscriminator ?? \"\");\n  return [\n    requireNonEmptyString(input.providerId, \"Provider id\"),\n    requireNonEmptyString(input.modelId, \"Model id\"),\n    requireNonEmptyString(input.voiceId, \"Voice id\"),\n    requireNonEmptyString(input.locale, \"Locale\"),\n    normalizeWhitespace(input.styleId ?? \"\") || \"_\",\n    requireNonEmptyString(input.format, \"Format\"),\n    requireNonEmptyString(\n      input.pronunciationVersion,\n      \"Pronunciation version\"\n    ),\n    scopeDiscriminator || \"global\",\n    normalizeAiSpeechText(input.normalizedRenderText),\n  ]\n    .map((segment) => encodeURIComponent(segment))\n    .join(\"::\");\n}\n\nexport function createAiSpeechNearReuseFingerprint(value: string): string {\n  const normalized = normalizeAiSpeechText(value)\n    .replace(/[^a-z0-9\\s]/gu, \" \")\n    .replace(/\\s+/gu, \" \")\n    .trim();\n\n  return requireNonEmptyString(normalized, \"Near-reuse fingerprint\");\n}\n\nexport function isAiSpeechNearReuseSafeClass(\n  utteranceClass: AiSpeechUtteranceClass\n): boolean {\n  return AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET.has(utteranceClass);\n}\n\nexport function planAiSpeechCache(\n  input: PlanAiSpeechCacheInput\n): AiSpeechCachePlan {\n  const rendered = renderAiSpeechText({\n    textTemplate: input.textTemplate,\n    playerAddress: input.playerAddress,\n  });\n  const enabledFeatureFlags: AiSpeechFeatureFlagKey[] = [];\n  const cacheEnabled = isAiSpeechFeatureEnabled(\n    AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    input.featureFlags\n  );\n\n  if (!cacheEnabled) {\n    return {\n      mode: \"disabled\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"tts-cache-rollout-disabled\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsCache);\n\n  if (input.voice.cachePermission === \"forbidden\") {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"provider-forbids-tts-caching\"],\n    };\n  }\n\n  const containsSensitiveContent =\n    Boolean(input.containsPersonalData) ||\n    Boolean(input.containsPrivateContext) ||\n    Boolean(input.containsModerationNotice) ||\n    Boolean(rendered.playerAddress?.redacted);\n  const actorScopeKey = normalizeWhitespace(input.actorScopeKey ?? \"\");\n\n  const actorScopeRequired =\n    containsSensitiveContent || input.utteranceClass === \"private-response\";\n\n  if (actorScopeRequired && !actorScopeKey) {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"actor-scope-key-required-for-sensitive-cache-entry\"],\n    };\n  }\n\n  const exactKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: rendered.normalizedRenderText,\n    scopeDiscriminator: actorScopeRequired ? actorScopeKey : undefined,\n  });\n\n  const nearReuseEnabled =\n    input.voice.cachePermission === \"exact-and-near\" &&\n    isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n      input.featureFlags\n    ) &&\n    isAiSpeechNearReuseSafeClass(input.utteranceClass) &&\n    !containsSensitiveContent &&\n    (rendered.playerAddress?.nearReuseAllowed ?? true);\n\n  if (!nearReuseEnabled) {\n    return {\n      mode: \"exact\",\n      sharingScope: actorScopeRequired ? \"actor\" : \"global\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      exactKey,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: containsSensitiveContent\n        ? [\"exact-cache-only-for-sensitive-or-redacted-content\"]\n        : [\"near-reuse-disabled-or-ineligible\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsNearReuse);\n\n  const nearKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: createAiSpeechNearReuseFingerprint(\n      rendered.normalizedRenderText\n    ),\n  });\n\n  return {\n    mode: \"near\",\n    sharingScope: \"global\",\n    renderText: rendered.renderText,\n    normalizedRenderText: rendered.normalizedRenderText,\n    exactKey,\n    nearKey,\n    enabledFeatureFlags,\n    playerAddress: rendered.playerAddress,\n    reasonCodes: [\"near-reuse-eligible\"],\n  };\n}\n\nexport const packageDescriptor: AiPackageDescriptor = Object.freeze({\n  packageName: AI_SPEECH_PACKAGE,\n  featureFlagId: AI_SPEECH_FEATURE_FLAG_ID,\n  envPrefix: AI_SPEECH_ENV_PREFIX,\n  summary:\n    \"Speech orchestration, TTS cache contracts, STT/TTS routing, and voice tier policy for Plasius AI.\",\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface AiPackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nfunction requireNonEmptyString(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new Error(`${label} must be a non-empty string.`);\n  }\n\n  return trimmed;\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/gu, \" \").trim();\n}\n\nexport const AI_SPEECH_PACKAGE = \"@plasius/ai-speech\";\nexport const AI_SPEECH_ENV_PREFIX = \"AI_SPEECH\";\n\nexport const AI_SPEECH_FEATURE_FLAGS = {\n  ttsCache: \"ai.tts.cache.enabled\",\n  ttsNearReuse: \"ai.tts.near-reuse.enabled\",\n  premiumCharacters: \"ai.tts.premium-characters.enabled\",\n} as const;\n\nexport type AiSpeechFeatureFlagKey =\n  (typeof AI_SPEECH_FEATURE_FLAGS)[keyof typeof AI_SPEECH_FEATURE_FLAGS];\n\nexport type AiSpeechFeatureFlagSnapshot = Readonly<\n  Record<string, boolean | undefined>\n>;\n\nexport const AI_SPEECH_FEATURE_FLAG_ID = AI_SPEECH_FEATURE_FLAGS.ttsCache;\n\nexport const AI_SPEECH_ROLLOUT_EVALUATORS = [\n  \"remote-flag-service\",\n  \"host-application\",\n  \"break-glass-env\",\n] as const;\n\nexport type AiSpeechRolloutEvaluator =\n  (typeof AI_SPEECH_ROLLOUT_EVALUATORS)[number];\n\nexport const AI_SPEECH_ROLLOUT_FALLBACK_MODES = [\n  \"fail-closed\",\n  \"fail-open\",\n] as const;\n\nexport type AiSpeechRolloutFallbackMode =\n  (typeof AI_SPEECH_ROLLOUT_FALLBACK_MODES)[number];\n\nexport interface AiSpeechRolloutControl {\n  readonly featureFlag: AiSpeechFeatureFlagKey;\n  readonly evaluator: AiSpeechRolloutEvaluator;\n  readonly defaultEnabled: boolean;\n  readonly fallbackMode: AiSpeechRolloutFallbackMode;\n}\n\nexport interface AiSpeechRolloutDecision extends AiSpeechRolloutControl {\n  readonly enabled: boolean;\n  readonly source: \"snapshot\" | \"default\";\n}\n\nexport const AI_SPEECH_ROLLOUTS = Object.freeze({\n  ttsCache: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  ttsNearReuse: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n  premiumCharacters: Object.freeze<AiSpeechRolloutControl>({\n    featureFlag: AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n    evaluator: \"remote-flag-service\",\n    defaultEnabled: false,\n    fallbackMode: \"fail-closed\",\n  }),\n});\n\nexport function resolveAiSpeechRolloutDecision(\n  control: AiSpeechRolloutControl,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): AiSpeechRolloutDecision {\n  const resolved = snapshot[control.featureFlag];\n  if (typeof resolved === \"boolean\") {\n    return {\n      ...control,\n      enabled: resolved,\n      source: \"snapshot\",\n    };\n  }\n\n  return {\n    ...control,\n    enabled: control.defaultEnabled,\n    source: \"default\",\n  };\n}\n\nexport function isAiSpeechFeatureEnabled(\n  featureFlag: AiSpeechFeatureFlagKey,\n  snapshot: AiSpeechFeatureFlagSnapshot = {}\n): boolean {\n  const control = Object.values(AI_SPEECH_ROLLOUTS).find(\n    (candidate) => candidate.featureFlag === featureFlag\n  );\n\n  if (!control) {\n    return false;\n  }\n\n  return resolveAiSpeechRolloutDecision(control, snapshot).enabled;\n}\n\nexport const AI_SPEECH_VOICE_TIERS = [\n  \"development\",\n  \"standard\",\n  \"premium-character\",\n] as const;\n\nexport type AiSpeechVoiceTier = (typeof AI_SPEECH_VOICE_TIERS)[number];\n\nexport const AI_SPEECH_ENVIRONMENTS = [\n  \"development\",\n  \"preview\",\n  \"production\",\n] as const;\n\nexport type AiSpeechEnvironment = (typeof AI_SPEECH_ENVIRONMENTS)[number];\n\nexport interface AiSpeechVoiceTierDecision {\n  readonly requestedTier: AiSpeechVoiceTier;\n  readonly resolvedTier: AiSpeechVoiceTier;\n  readonly fallbackTier?: AiSpeechVoiceTier;\n  readonly reasonCodes: readonly string[];\n}\n\nexport interface ResolveAiSpeechVoiceTierInput {\n  readonly environment: AiSpeechEnvironment;\n  readonly requestedTier?: AiSpeechVoiceTier;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n}\n\nexport function resolveAiSpeechVoiceTier(\n  input: ResolveAiSpeechVoiceTierInput\n): AiSpeechVoiceTierDecision {\n  const requestedTier =\n    input.requestedTier ??\n    (input.environment === \"development\" ? \"development\" : \"standard\");\n\n  if (\n    requestedTier === \"premium-character\" &&\n    !isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.premiumCharacters,\n      input.featureFlags\n    )\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"premium-character-rollout-disabled\"],\n    };\n  }\n\n  if (\n    requestedTier === \"development\" &&\n    input.environment !== \"development\"\n  ) {\n    return {\n      requestedTier,\n      resolvedTier: \"standard\",\n      fallbackTier: \"standard\",\n      reasonCodes: [\"development-voices-limited-to-development-environments\"],\n    };\n  }\n\n  return {\n    requestedTier,\n    resolvedTier: requestedTier,\n    reasonCodes: [],\n  };\n}\n\nexport const AI_SPEECH_PLAYER_ADDRESS_SOURCES = [\n  \"generic-player\",\n  \"class-title\",\n  \"faction-title\",\n  \"authored-character\",\n  \"user-name\",\n  \"account-handle\",\n  \"user-renamed-character\",\n] as const;\n\nexport type AiSpeechPlayerAddressSource =\n  (typeof AI_SPEECH_PLAYER_ADDRESS_SOURCES)[number];\n\nexport const AI_SPEECH_DEFAULT_PLAYER_LABEL = \"Player\";\n\nexport interface AiSpeechPlayerAddressInput {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly rawValue?: string;\n  readonly fallbackLabel?: string;\n}\n\nexport interface AiSpeechPlayerAddressDecision {\n  readonly source: AiSpeechPlayerAddressSource;\n  readonly renderText: string;\n  readonly exactReuseAllowed: boolean;\n  readonly nearReuseAllowed: boolean;\n  readonly redacted: boolean;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function resolveAiSpeechPlayerAddress(\n  input: AiSpeechPlayerAddressInput\n): AiSpeechPlayerAddressDecision {\n  const fallbackLabel =\n    normalizeWhitespace(input.fallbackLabel ?? \"\") ||\n    AI_SPEECH_DEFAULT_PLAYER_LABEL;\n  const rawValue = normalizeWhitespace(input.rawValue ?? \"\");\n\n  switch (input.source) {\n    case \"generic-player\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: [\"generic-player-address\"],\n      };\n    case \"class-title\":\n    case \"faction-title\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"authored-character\":\n      return {\n        source: input.source,\n        renderText: rawValue || fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: true,\n        redacted: false,\n        reasonCodes: rawValue ? [] : [\"player-address-fell-back-to-generic-label\"],\n      };\n    case \"user-name\":\n    case \"account-handle\":\n    case \"user-renamed-character\":\n      return {\n        source: input.source,\n        renderText: fallbackLabel,\n        exactReuseAllowed: true,\n        nearReuseAllowed: false,\n        redacted: true,\n        reasonCodes: [\"player-identifier-redacted-from-render-text\"],\n      };\n  }\n}\n\nexport interface AiSpeechRenderTextInput {\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n}\n\nexport interface AiSpeechRenderTextResult {\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n}\n\nexport function renderAiSpeechText(\n  input: AiSpeechRenderTextInput\n): AiSpeechRenderTextResult {\n  const textTemplate = requireNonEmptyString(\n    input.textTemplate,\n    \"Speech text template\"\n  );\n  const hasPlayerPlaceholder = textTemplate.includes(\"{playerAddress}\");\n\n  if (hasPlayerPlaceholder && !input.playerAddress) {\n    throw new Error(\n      \"Speech text template requires playerAddress when using the {playerAddress} placeholder.\"\n    );\n  }\n\n  const playerAddress = input.playerAddress\n    ? resolveAiSpeechPlayerAddress(input.playerAddress)\n    : undefined;\n  const renderText = normalizeWhitespace(\n    hasPlayerPlaceholder && playerAddress\n      ? textTemplate.replace(/\\{playerAddress\\}/gu, playerAddress.renderText)\n      : textTemplate\n  );\n\n  return {\n    renderText,\n    normalizedRenderText: normalizeAiSpeechText(renderText),\n    playerAddress,\n  };\n}\n\nexport function normalizeAiSpeechText(value: string): string {\n  return requireNonEmptyString(\n    normalizeWhitespace(value).toLocaleLowerCase(\"en-GB\"),\n    \"Speech text\"\n  );\n}\n\nexport const AI_SPEECH_PROVIDER_CACHE_PERMISSIONS = [\n  \"forbidden\",\n  \"exact-only\",\n  \"exact-and-near\",\n] as const;\n\nexport type AiSpeechProviderCachePermission =\n  (typeof AI_SPEECH_PROVIDER_CACHE_PERMISSIONS)[number];\n\nexport const AI_SPEECH_CACHE_MODES = [\n  \"disabled\",\n  \"no-cache\",\n  \"exact\",\n  \"near\",\n] as const;\n\nexport type AiSpeechCacheMode = (typeof AI_SPEECH_CACHE_MODES)[number];\n\nexport const AI_SPEECH_CACHE_SCOPES = [\"none\", \"actor\", \"global\"] as const;\n\nexport type AiSpeechCacheScope = (typeof AI_SPEECH_CACHE_SCOPES)[number];\n\nexport const AI_SPEECH_UTTERANCE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n  \"moderation-notice\",\n  \"private-response\",\n] as const;\n\nexport type AiSpeechUtteranceClass =\n  (typeof AI_SPEECH_UTTERANCE_CLASSES)[number];\n\nexport const AI_SPEECH_NEAR_REUSE_SAFE_CLASSES = [\n  \"system-generic\",\n  \"game-npc-dialogue\",\n  \"game-bark\",\n  \"player-address\",\n] as const satisfies readonly AiSpeechUtteranceClass[];\n\nconst AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET: ReadonlySet<AiSpeechUtteranceClass> =\n  new Set(AI_SPEECH_NEAR_REUSE_SAFE_CLASSES);\n\nexport interface AiSpeechCacheKeyInput {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly normalizedRenderText: string;\n  readonly styleId?: string;\n  readonly scopeDiscriminator?: string;\n}\n\nexport interface AiSpeechVoiceProfileRef {\n  readonly providerId: string;\n  readonly modelId: string;\n  readonly voiceId: string;\n  readonly locale: string;\n  readonly format: string;\n  readonly pronunciationVersion: string;\n  readonly styleId?: string;\n  readonly cachePermission: AiSpeechProviderCachePermission;\n  readonly tier?: AiSpeechVoiceTier;\n  readonly profileId?: string;\n}\n\nexport interface AiSpeechCacheTelemetry {\n  readonly cacheHits: number;\n  readonly nearCacheHits: number;\n  readonly cacheMisses: number;\n  readonly charactersSaved: number;\n  readonly estimatedCostSavedUsd?: number;\n  readonly voiceProfileIds?: readonly string[];\n}\n\nexport interface PlanAiSpeechCacheInput {\n  readonly utteranceClass: AiSpeechUtteranceClass;\n  readonly textTemplate: string;\n  readonly playerAddress?: AiSpeechPlayerAddressInput;\n  readonly voice: AiSpeechVoiceProfileRef;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n  readonly actorScopeKey?: string;\n  readonly containsPersonalData?: boolean;\n  readonly containsPrivateContext?: boolean;\n  readonly containsModerationNotice?: boolean;\n}\n\nexport interface AiSpeechCachePlan {\n  readonly mode: AiSpeechCacheMode;\n  readonly sharingScope: AiSpeechCacheScope;\n  readonly renderText: string;\n  readonly normalizedRenderText: string;\n  readonly exactKey?: string;\n  readonly nearKey?: string;\n  readonly enabledFeatureFlags: readonly AiSpeechFeatureFlagKey[];\n  readonly playerAddress?: AiSpeechPlayerAddressDecision;\n  readonly reasonCodes: readonly string[];\n}\n\nexport function createAiSpeechCacheKey(input: AiSpeechCacheKeyInput): string {\n  const scopeDiscriminator = normalizeWhitespace(input.scopeDiscriminator ?? \"\");\n  return [\n    requireNonEmptyString(input.providerId, \"Provider id\"),\n    requireNonEmptyString(input.modelId, \"Model id\"),\n    requireNonEmptyString(input.voiceId, \"Voice id\"),\n    requireNonEmptyString(input.locale, \"Locale\"),\n    normalizeWhitespace(input.styleId ?? \"\") || \"_\",\n    requireNonEmptyString(input.format, \"Format\"),\n    requireNonEmptyString(\n      input.pronunciationVersion,\n      \"Pronunciation version\"\n    ),\n    scopeDiscriminator || \"global\",\n    normalizeAiSpeechText(input.normalizedRenderText),\n  ]\n    .map((segment) => encodeURIComponent(segment))\n    .join(\"::\");\n}\n\nexport function createAiSpeechNearReuseFingerprint(value: string): string {\n  const normalized = normalizeAiSpeechText(value)\n    .replace(/[^a-z0-9\\s]/gu, \" \")\n    .replace(/\\s+/gu, \" \")\n    .trim();\n\n  return requireNonEmptyString(normalized, \"Near-reuse fingerprint\");\n}\n\nexport function isAiSpeechNearReuseSafeClass(\n  utteranceClass: AiSpeechUtteranceClass\n): boolean {\n  return AI_SPEECH_NEAR_REUSE_SAFE_CLASS_SET.has(utteranceClass);\n}\n\nexport function planAiSpeechCache(\n  input: PlanAiSpeechCacheInput\n): AiSpeechCachePlan {\n  const rendered = renderAiSpeechText({\n    textTemplate: input.textTemplate,\n    playerAddress: input.playerAddress,\n  });\n  const enabledFeatureFlags: AiSpeechFeatureFlagKey[] = [];\n  const cacheEnabled = isAiSpeechFeatureEnabled(\n    AI_SPEECH_FEATURE_FLAGS.ttsCache,\n    input.featureFlags\n  );\n\n  if (!cacheEnabled) {\n    return {\n      mode: \"disabled\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"tts-cache-rollout-disabled\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsCache);\n\n  if (input.voice.cachePermission === \"forbidden\") {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"provider-forbids-tts-caching\"],\n    };\n  }\n\n  const containsSensitiveContent =\n    Boolean(input.containsPersonalData) ||\n    Boolean(input.containsPrivateContext) ||\n    Boolean(input.containsModerationNotice) ||\n    Boolean(rendered.playerAddress?.redacted);\n  const actorScopeKey = normalizeWhitespace(input.actorScopeKey ?? \"\");\n\n  const actorScopeRequired =\n    containsSensitiveContent || input.utteranceClass === \"private-response\";\n\n  if (actorScopeRequired && !actorScopeKey) {\n    return {\n      mode: \"no-cache\",\n      sharingScope: \"none\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: [\"actor-scope-key-required-for-sensitive-cache-entry\"],\n    };\n  }\n\n  const exactKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: rendered.normalizedRenderText,\n    scopeDiscriminator: actorScopeRequired ? actorScopeKey : undefined,\n  });\n\n  const nearReuseEnabled =\n    input.voice.cachePermission === \"exact-and-near\" &&\n    isAiSpeechFeatureEnabled(\n      AI_SPEECH_FEATURE_FLAGS.ttsNearReuse,\n      input.featureFlags\n    ) &&\n    isAiSpeechNearReuseSafeClass(input.utteranceClass) &&\n    !containsSensitiveContent &&\n    (rendered.playerAddress?.nearReuseAllowed ?? true);\n\n  if (!nearReuseEnabled) {\n    return {\n      mode: \"exact\",\n      sharingScope: actorScopeRequired ? \"actor\" : \"global\",\n      renderText: rendered.renderText,\n      normalizedRenderText: rendered.normalizedRenderText,\n      exactKey,\n      enabledFeatureFlags,\n      playerAddress: rendered.playerAddress,\n      reasonCodes: containsSensitiveContent\n        ? [\"exact-cache-only-for-sensitive-or-redacted-content\"]\n        : [\"near-reuse-disabled-or-ineligible\"],\n    };\n  }\n\n  enabledFeatureFlags.push(AI_SPEECH_FEATURE_FLAGS.ttsNearReuse);\n\n  const nearKey = createAiSpeechCacheKey({\n    ...input.voice,\n    normalizedRenderText: createAiSpeechNearReuseFingerprint(\n      rendered.normalizedRenderText\n    ),\n  });\n\n  return {\n    mode: \"near\",\n    sharingScope: \"global\",\n    renderText: rendered.renderText,\n    normalizedRenderText: rendered.normalizedRenderText,\n    exactKey,\n    nearKey,\n    enabledFeatureFlags,\n    playerAddress: rendered.playerAddress,\n    reasonCodes: [\"near-reuse-eligible\"],\n  };\n}\n\nexport const AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID =\n  \"isekai.player-system.audio.enabled\" as const;\n\nexport const AI_SPEECH_AUDIO_CHANNELS = [\n  \"narrated-response\",\n  \"localized-cue\",\n  \"repeating-warning\",\n] as const;\n\nexport type AiSpeechAudioChannel = (typeof AI_SPEECH_AUDIO_CHANNELS)[number];\n\nexport const AI_SPEECH_AUDIO_PRIORITIES = [\n  \"critical\",\n  \"high\",\n  \"normal\",\n  \"low\",\n] as const;\n\nexport type AiSpeechAudioPriority =\n  (typeof AI_SPEECH_AUDIO_PRIORITIES)[number];\n\nexport const AI_SPEECH_AUDIO_DUCKING_MODES = [\n  \"none\",\n  \"music\",\n  \"non-critical\",\n  \"lower-priority\",\n] as const;\n\nexport type AiSpeechAudioDuckingMode =\n  (typeof AI_SPEECH_AUDIO_DUCKING_MODES)[number];\n\nexport const AI_SPEECH_AUDIO_CUE_FAMILIES = [\n  \"status\",\n  \"tutorial\",\n  \"mission\",\n  \"mcc\",\n  \"warning\",\n] as const;\n\nexport type AiSpeechAudioCueFamily =\n  (typeof AI_SPEECH_AUDIO_CUE_FAMILIES)[number];\n\nexport const AI_SPEECH_AUDIO_FOCUS_MODES = [\n  \"ambient\",\n  \"focused\",\n  \"combat-safe\",\n] as const;\n\nexport type AiSpeechAudioFocusMode =\n  (typeof AI_SPEECH_AUDIO_FOCUS_MODES)[number];\n\nexport const AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES = [\n  \"full\",\n  \"condensed\",\n  \"deferred\",\n  \"suppressed\",\n] as const;\n\nexport type AiSpeechAudioCombatSafeDelivery =\n  (typeof AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES)[number];\n\nexport interface AiSpeechAudioContractBase {\n  readonly id: string;\n  readonly featureFlagId: typeof AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID;\n  readonly priority: AiSpeechAudioPriority;\n  readonly ducking: AiSpeechAudioDuckingMode;\n  readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;\n}\n\nexport interface AiSpeechNarratedResponseContract\n  extends AiSpeechAudioContractBase {\n  readonly channel: \"narrated-response\";\n  readonly utteranceId: string;\n  readonly locale: string;\n}\n\nexport interface AiSpeechLocalizedCueContract extends AiSpeechAudioContractBase {\n  readonly channel: \"localized-cue\";\n  readonly cueFamily: AiSpeechAudioCueFamily;\n  readonly cueId: string;\n  readonly locale: string;\n}\n\nexport interface AiSpeechRepeatingWarningContract\n  extends AiSpeechAudioContractBase {\n  readonly channel: \"repeating-warning\";\n  readonly warningId: string;\n  readonly intervalSeconds: number;\n  readonly maximumOccurrencesPerMinute: number;\n}\n\nexport type AiSpeechAudioContract =\n  | AiSpeechNarratedResponseContract\n  | AiSpeechLocalizedCueContract\n  | AiSpeechRepeatingWarningContract;\n\nexport interface AiSpeechAudioContractBaseInput {\n  readonly id: string;\n  readonly priority: AiSpeechAudioPriority;\n  readonly ducking: AiSpeechAudioDuckingMode;\n  readonly combatSafeDelivery: AiSpeechAudioCombatSafeDelivery;\n}\n\nexport interface CreateAiSpeechNarratedResponseInput\n  extends AiSpeechAudioContractBaseInput {\n  readonly utteranceId: string;\n  readonly locale: string;\n}\n\nexport interface CreateAiSpeechLocalizedCueInput\n  extends AiSpeechAudioContractBaseInput {\n  readonly cueFamily: AiSpeechAudioCueFamily;\n  readonly cueId: string;\n  readonly locale: string;\n}\n\nexport interface CreateAiSpeechRepeatingWarningInput\n  extends AiSpeechAudioContractBaseInput {\n  readonly warningId: string;\n  readonly intervalSeconds: number;\n  readonly maximumOccurrencesPerMinute: number;\n}\n\nfunction requireAudioEnum<T extends string>(\n  value: T,\n  allowed: readonly T[],\n  label: string\n): T {\n  if (!allowed.includes(value)) {\n    throw new Error(`${label} is not supported: ${value}.`);\n  }\n\n  return value;\n}\n\nfunction requireBoundedAudioNumber(\n  value: number,\n  minimum: number,\n  maximum: number,\n  label: string\n): number {\n  if (!Number.isFinite(value) || value < minimum || value > maximum) {\n    throw new Error(\n      `${label} must be between ${minimum} and ${maximum}, inclusive.`\n    );\n  }\n\n  return value;\n}\n\nfunction createAiSpeechAudioContractBase(\n  input: AiSpeechAudioContractBaseInput\n): AiSpeechAudioContractBase {\n  return {\n    id: requireNonEmptyString(input.id, \"Audio contract id\"),\n    featureFlagId: AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID,\n    priority: requireAudioEnum(\n      input.priority,\n      AI_SPEECH_AUDIO_PRIORITIES,\n      \"Audio priority\"\n    ),\n    ducking: requireAudioEnum(\n      input.ducking,\n      AI_SPEECH_AUDIO_DUCKING_MODES,\n      \"Audio ducking mode\"\n    ),\n    combatSafeDelivery: requireAudioEnum(\n      input.combatSafeDelivery,\n      AI_SPEECH_AUDIO_COMBAT_SAFE_DELIVERIES,\n      \"Combat-safe audio delivery\"\n    ),\n  };\n}\n\nexport function createAiSpeechNarratedResponse(\n  input: CreateAiSpeechNarratedResponseInput\n): AiSpeechNarratedResponseContract {\n  return Object.freeze({\n    ...createAiSpeechAudioContractBase(input),\n    channel: \"narrated-response\" as const,\n    utteranceId: requireNonEmptyString(input.utteranceId, \"Utterance id\"),\n    locale: requireNonEmptyString(input.locale, \"Locale\"),\n  });\n}\n\nexport function createAiSpeechLocalizedCue(\n  input: CreateAiSpeechLocalizedCueInput\n): AiSpeechLocalizedCueContract {\n  return Object.freeze({\n    ...createAiSpeechAudioContractBase(input),\n    channel: \"localized-cue\" as const,\n    cueFamily: requireAudioEnum(\n      input.cueFamily,\n      AI_SPEECH_AUDIO_CUE_FAMILIES,\n      \"Audio cue family\"\n    ),\n    cueId: requireNonEmptyString(input.cueId, \"Cue id\"),\n    locale: requireNonEmptyString(input.locale, \"Locale\"),\n  });\n}\n\nexport function createAiSpeechRepeatingWarning(\n  input: CreateAiSpeechRepeatingWarningInput\n): AiSpeechRepeatingWarningContract {\n  return Object.freeze({\n    ...createAiSpeechAudioContractBase(input),\n    channel: \"repeating-warning\" as const,\n    warningId: requireNonEmptyString(input.warningId, \"Warning id\"),\n    intervalSeconds: requireBoundedAudioNumber(\n      input.intervalSeconds,\n      1,\n      3600,\n      \"Warning intervalSeconds\"\n    ),\n    maximumOccurrencesPerMinute: requireBoundedAudioNumber(\n      input.maximumOccurrencesPerMinute,\n      1,\n      60,\n      \"Warning maximumOccurrencesPerMinute\"\n    ),\n  });\n}\n\nexport interface ResolveAiSpeechAudioPolicyInput {\n  readonly contract: AiSpeechAudioContract;\n  readonly focusMode: AiSpeechAudioFocusMode;\n  readonly featureFlags?: AiSpeechFeatureFlagSnapshot;\n  readonly masterMuted?: boolean;\n  readonly userMuted?: boolean;\n  readonly activeContractIds?: readonly string[];\n}\n\nexport interface AiSpeechAudioPolicyDecision {\n  readonly deliver: boolean;\n  readonly mode: \"full\" | \"condensed\" | \"deferred\";\n  readonly ducking: AiSpeechAudioDuckingMode;\n  readonly reasonCodes: readonly string[];\n}\n\nfunction isPlayerSystemAudioEnabled(\n  featureFlags: AiSpeechFeatureFlagSnapshot = {}\n): boolean {\n  return featureFlags[AI_SPEECH_PLAYER_SYSTEM_AUDIO_FLAG_ID] === true;\n}\n\nexport function resolveAiSpeechAudioPolicy(\n  input: ResolveAiSpeechAudioPolicyInput\n): AiSpeechAudioPolicyDecision {\n  const { contract } = input;\n\n  if (!isPlayerSystemAudioEnabled(input.featureFlags)) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"player-system-audio-rollout-disabled\"],\n    };\n  }\n\n  if (input.masterMuted || input.userMuted) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [input.masterMuted ? \"master-muted\" : \"user-muted\"],\n    };\n  }\n\n  if (input.activeContractIds?.includes(contract.id)) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"duplicate-audio-contract-suppressed\"],\n    };\n  }\n\n  if (\n    input.focusMode === \"combat-safe\" &&\n    contract.priority !== \"critical\" &&\n    contract.priority !== \"high\"\n  ) {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"combat-safe-priority-suppressed\"],\n    };\n  }\n\n  if (contract.combatSafeDelivery === \"suppressed\") {\n    return {\n      deliver: false,\n      mode: \"deferred\",\n      ducking: \"none\",\n      reasonCodes: [\"audio-contract-suppressed\"],\n    };\n  }\n\n  const mode =\n    input.focusMode === \"combat-safe\"\n      ? contract.combatSafeDelivery === \"condensed\"\n        ? \"condensed\"\n        : contract.combatSafeDelivery === \"deferred\"\n          ? \"deferred\"\n          : \"full\"\n      : \"full\";\n  const ducking = contract.priority === \"critical\" ? \"none\" : contract.ducking;\n\n  return {\n    deliver: mode !== \"deferred\",\n    mode,\n    ducking,\n    reasonCodes:\n      contract.priority === \"critical\"\n        ? [\"critical-priority-bypasses-ducking\"]\n        : [],\n  };\n}\n\nexport const packageDescriptor: AiPackageDescriptor = Object.freeze({\n  packageName: AI_SPEECH_PACKAGE,\n  featureFlagId: AI_SPEECH_FEATURE_FLAG_ID,\n  envPrefix: AI_SPEECH_ENV_PREFIX,\n  summary:\n    \"Speech orchestration, TTS cache contracts, STT/TTS routing, and voice tier policy for Plasius AI.\",\n});\n"],"mappings":"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","names":[]}

package/docs/adrs/adr-0003-player-system-audio-contracts.md

@@ -0,0 +1,52 @@
+# ADR-0003: Player System Audio Contract Boundary
+
+- Date: 2026-07-12
+- Status: Accepted
+
+## Context
+
+The Player System needs stable speech-domain contracts for narrated responses,
+localized one-shot cues, and repeating warnings. If each host defines these
+channels and combat behavior independently, priority, ducking, suppression, and
+fallback behavior will drift between the site and package consumers.
+
+The package must remain provider- and runtime-independent. Raw narration text,
+provider credentials, audio assets, playback engines, and feature-flag fetching
+must remain outside the public contract package.
+
+## Decision
+
+`@plasius/ai-speech` owns immutable metadata contracts for the three audio
+channels and deterministic policy evaluation over caller-supplied state. The
+contracts use opaque IDs and locales, reuse the Player System priority
+vocabulary, require explicit ducking and combat-safe delivery behavior, and
+bound repeating-warning intervals and frequencies.
+
+The policy is fail-closed when `isekai.player-system.audio.enabled` is absent or
+false, when audio is muted, when a dispatch is duplicated, or when combat-safe
+mode suppresses its priority. Critical audio bypasses ducking; normal and low
+priority audio are suppressed during combat-safe mode; narration may be
+condensed or deferred according to its contract.
+
+Hosts own feature-flag evaluation, translations, asset resolution, playback,
+captions, and non-audio accessibility fallbacks.
+
+## Alternatives considered
+
+- Keep the audio channel model in each host: rejected because consumers would
+  reinterpret priority and combat-safe rules independently.
+- Store raw narration text in the package contract: rejected because it would
+  increase privacy and telemetry exposure without helping playback adapters.
+- Depend on a playback engine or provider SDK: rejected because native, server,
+  browser, and test consumers need the same portable contract surface.
+
+## Impact and validation
+
+- Public consumers can construct and evaluate deterministic, bounded dispatch
+  metadata without runtime dependencies.
+- The package remains compatible with existing TTS cache and voice-tier APIs.
+- Unit tests cover channel separation, validation bounds, rollout fail-closed
+  behavior, combat-safe reduction, critical ducking bypass, duplicate
+  suppression, and mute handling.
+- Release remains the normal package CI and approved `cd.yml` path; no provider
+  or runtime deployment is introduced by this decision.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/ai-speech",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Speech orchestration, TTS cache contracts, STT/TTS routing, and voice tier policy for Plasius AI.",
   "type": "module",
   "sideEffects": false,
@@ -64,16 +64,16 @@
   "homepage": "https://github.com/Plasius-LTD/ai-speech#readme",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.7.0",
-    "@typescript-eslint/eslint-plugin": "^8.59.3",
-    "@typescript-eslint/parser": "^8.59.3",
-    "@vitest/coverage-v8": "^4.1.6",
-    "eslint": "^10.3.0",
-    "globals": "^17.6.0",
+    "@types/node": "^26.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.62.0",
+    "@typescript-eslint/parser": "^8.62.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "eslint": "^10.6.0",
+    "globals": "^17.7.0",
     "rimraf": "^6.1.3",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.9"
   },
   "publishConfig": {
     "access": "public"