@ai-rpg-engine/audio-director 2.0.0

package/dist/director.d.ts

@@ -0,0 +1,27 @@
+import type { NarrationPlan } from '@ai-rpg-engine/presentation';
+import type { AudioCommand, AudioDomain, AudioDirectorConfig, DuckingRule } from './types.js';
+/** Deterministic audio cue scheduling engine. */
+export declare class AudioDirector {
+    private cooldowns;
+    private activeLayers;
+    private duckingRules;
+    private domainPriorities;
+    private defaultCooldownMs;
+    constructor(config?: AudioDirectorConfig);
+    /** Convert a NarrationPlan into sequenced AudioCommands, applying cooldowns and ducking. */
+    schedule(plan: NarrationPlan): AudioCommand[];
+    /** Check if a resource is currently on cooldown. */
+    isOnCooldown(resourceId: string): boolean;
+    /** Register a ducking rule. */
+    addDuckingRule(rule: DuckingRule): void;
+    /** Get currently active audio layers. */
+    getActiveLayers(): Map<string, {
+        domain: AudioDomain;
+        resourceId: string;
+    }>;
+    /** Clear all cooldowns (e.g. on scene change). */
+    clearCooldowns(): void;
+    /** Build ducking commands based on active triggers. */
+    private buildDuckingCommands;
+}
+//# sourceMappingURL=director.d.ts.map

package/dist/director.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"director.d.ts","sourceRoot":"","sources":["../src/director.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,mBAAmB,EAEnB,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,iDAAiD;AACjD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,YAAY,CAAkE;IACtF,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,MAAM,CAAC,EAAE,mBAAmB;IAMxC,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE;IA2C7C,oDAAoD;IACpD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAMzC,+BAA+B;IAC/B,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIvC,yCAAyC;IACzC,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3E,kDAAkD;IAClD,cAAc,IAAI,IAAI;IAItB,uDAAuD;IACvD,OAAO,CAAC,oBAAoB;CAmB7B"}

package/dist/director.js

@@ -0,0 +1,94 @@
+// Audio Director — cue scheduling with priority, cooldowns, and ducking
+import { DEFAULT_DOMAIN_PRIORITIES, DEFAULT_DUCKING_RULES } from './types.js';
+import { scheduleAll } from './scheduler.js';
+/** Deterministic audio cue scheduling engine. */
+export class AudioDirector {
+    cooldowns = new Map();
+    activeLayers = new Map();
+    duckingRules;
+    domainPriorities;
+    defaultCooldownMs;
+    constructor(config) {
+        this.defaultCooldownMs = config?.defaultCooldownMs ?? 2000;
+        this.duckingRules = config?.duckingRules ?? [...DEFAULT_DUCKING_RULES];
+        this.domainPriorities = config?.domainPriorities ?? { ...DEFAULT_DOMAIN_PRIORITIES };
+    }
+    /** Convert a NarrationPlan into sequenced AudioCommands, applying cooldowns and ducking. */
+    schedule(plan) {
+        const now = Date.now();
+        const raw = scheduleAll(plan, this.domainPriorities);
+        // Filter out cooled-down resources
+        const filtered = raw.filter((cmd) => {
+            if (cmd.action !== 'play')
+                return true;
+            return !this.isOnCooldown(cmd.resourceId);
+        });
+        // Add ducking commands for active triggers
+        const ducking = this.buildDuckingCommands(filtered);
+        // Update cooldowns for played resources
+        for (const cmd of filtered) {
+            if (cmd.action === 'play' && cmd.domain === 'sfx') {
+                this.cooldowns.set(cmd.resourceId, {
+                    resourceId: cmd.resourceId,
+                    lastPlayedMs: now,
+                    cooldownMs: this.defaultCooldownMs,
+                });
+            }
+        }
+        // Track active ambient layers
+        for (const cmd of filtered) {
+            if (cmd.domain === 'ambient') {
+                if (cmd.action === 'stop') {
+                    this.activeLayers.delete(cmd.resourceId);
+                }
+                else {
+                    this.activeLayers.set(cmd.resourceId, {
+                        domain: 'ambient',
+                        resourceId: cmd.resourceId,
+                    });
+                }
+            }
+        }
+        const all = [...filtered, ...ducking];
+        all.sort((a, b) => a.timing - b.timing || b.priority - a.priority);
+        return all;
+    }
+    /** Check if a resource is currently on cooldown. */
+    isOnCooldown(resourceId) {
+        const entry = this.cooldowns.get(resourceId);
+        if (!entry)
+            return false;
+        return Date.now() - entry.lastPlayedMs < entry.cooldownMs;
+    }
+    /** Register a ducking rule. */
+    addDuckingRule(rule) {
+        this.duckingRules.push(rule);
+    }
+    /** Get currently active audio layers. */
+    getActiveLayers() {
+        return new Map(this.activeLayers);
+    }
+    /** Clear all cooldowns (e.g. on scene change). */
+    clearCooldowns() {
+        this.cooldowns.clear();
+    }
+    /** Build ducking commands based on active triggers. */
+    buildDuckingCommands(commands) {
+        const ducking = [];
+        const triggerDomains = new Set(commands.filter((c) => c.action === 'play').map((c) => c.domain));
+        for (const rule of this.duckingRules) {
+            if (triggerDomains.has(rule.trigger)) {
+                ducking.push({
+                    domain: rule.target,
+                    action: 'duck',
+                    resourceId: '__all__',
+                    priority: this.domainPriorities[rule.trigger],
+                    timing: 0,
+                    params: { duckLevel: rule.duckLevel, fadeMs: rule.fadeMs },
+                });
+            }
+        }
+        return ducking;
+    }
+}
+//# sourceMappingURL=director.js.map

package/dist/director.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"director.js","sourceRoot":"","sources":["../src/director.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { AudioDomain, AudioCommand, DuckingRule, CooldownEntry, AudioDirectorConfig, } from './types.js';
+export { DEFAULT_DOMAIN_PRIORITIES, DEFAULT_DUCKING_RULES, } from './types.js';
+export { AudioDirector } from './director.js';
+export { scheduleAll, scheduleSfx, scheduleAmbient, scheduleMusic, scheduleVoice, } from './scheduler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { DEFAULT_DOMAIN_PRIORITIES, DEFAULT_DUCKING_RULES, } from './types.js';
+export { AudioDirector } from './director.js';
+export { scheduleAll, scheduleSfx, scheduleAmbient, scheduleMusic, scheduleVoice, } from './scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/scheduler.d.ts

@@ -0,0 +1,13 @@
+import type { NarrationPlan, SfxCue, AmbientCue, MusicCue, SpeakerCue } from '@ai-rpg-engine/presentation';
+import type { AudioCommand, AudioDomain } from './types.js';
+/** Convert SFX cues to AudioCommands with timing offsets. */
+export declare function scheduleSfx(sfx: SfxCue[], speechDurationMs: number, basePriority: number): AudioCommand[];
+/** Convert ambient cues to AudioCommands. */
+export declare function scheduleAmbient(layers: AmbientCue[], basePriority: number): AudioCommand[];
+/** Convert a music cue to an AudioCommand. */
+export declare function scheduleMusic(cue: MusicCue, basePriority: number): AudioCommand;
+/** Convert a speaker cue to a voice AudioCommand. */
+export declare function scheduleVoice(cue: SpeakerCue, basePriority: number): AudioCommand;
+/** Schedule all cues from a NarrationPlan into ordered AudioCommands. */
+export declare function scheduleAll(plan: NarrationPlan, domainPriorities: Record<AudioDomain, number>): AudioCommand[];
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC3G,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS5D,6DAA6D;AAC7D,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EAAE,EACb,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,GACnB,YAAY,EAAE,CAehB;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAAE,EACpB,YAAY,EAAE,MAAM,GACnB,YAAY,EAAE,CAShB;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,MAAM,GACnB,YAAY,CASd;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,UAAU,EACf,YAAY,EAAE,MAAM,GACnB,YAAY,CAcd;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,EACnB,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAC5C,YAAY,EAAE,CAkChB"}

package/dist/scheduler.js

@@ -0,0 +1,95 @@
+// Timing and sequencing logic for audio commands
+/** Estimate speech duration in ms from text length. */
+function estimateSpeechDurationMs(text, speed) {
+    const wordsPerMinute = 150 * speed;
+    const wordCount = text.split(/\s+/).length;
+    return Math.round((wordCount / wordsPerMinute) * 60_000);
+}
+/** Convert SFX cues to AudioCommands with timing offsets. */
+export function scheduleSfx(sfx, speechDurationMs, basePriority) {
+    return sfx.map((cue) => {
+        let timing = 0;
+        if (cue.timing === 'with-text')
+            timing = 200;
+        else if (cue.timing === 'after-text')
+            timing = speechDurationMs + 100;
+        return {
+            domain: 'sfx',
+            action: 'play',
+            resourceId: cue.effectId,
+            priority: basePriority,
+            timing,
+            params: { intensity: cue.intensity },
+        };
+    });
+}
+/** Convert ambient cues to AudioCommands. */
+export function scheduleAmbient(layers, basePriority) {
+    return layers.map((cue) => ({
+        domain: 'ambient',
+        action: cue.action,
+        resourceId: cue.layerId,
+        priority: basePriority,
+        timing: 0,
+        params: { volume: cue.volume, fadeMs: cue.fadeMs },
+    }));
+}
+/** Convert a music cue to an AudioCommand. */
+export function scheduleMusic(cue, basePriority) {
+    return {
+        domain: 'music',
+        action: cue.action,
+        resourceId: cue.trackId ?? '',
+        priority: basePriority,
+        timing: 0,
+        params: { fadeMs: cue.fadeMs },
+    };
+}
+/** Convert a speaker cue to a voice AudioCommand. */
+export function scheduleVoice(cue, basePriority) {
+    return {
+        domain: 'voice',
+        action: 'play',
+        resourceId: cue.voiceId,
+        priority: basePriority,
+        timing: 0,
+        params: {
+            text: cue.text,
+            emotion: cue.emotion,
+            speed: cue.speed,
+            entityId: cue.entityId,
+        },
+    };
+}
+/** Schedule all cues from a NarrationPlan into ordered AudioCommands. */
+export function scheduleAll(plan, domainPriorities) {
+    const commands = [];
+    const speechMs = plan.voiceProfile
+        ? estimateSpeechDurationMs(plan.sceneText, plan.voiceProfile.speed)
+        : estimateSpeechDurationMs(plan.sceneText, 1.0);
+    // Voice (narrator or speaker)
+    if (plan.speaker) {
+        commands.push(scheduleVoice(plan.speaker, domainPriorities.voice));
+    }
+    else if (plan.voiceProfile) {
+        commands.push(scheduleVoice({
+            entityId: '__narrator__',
+            voiceId: plan.voiceProfile.voiceId,
+            emotion: plan.voiceProfile.emotion,
+            speed: plan.voiceProfile.speed,
+            text: plan.sceneText,
+        }, domainPriorities.voice));
+    }
+    // SFX
+    commands.push(...scheduleSfx(plan.sfx, speechMs, domainPriorities.sfx));
+    // Ambient
+    commands.push(...scheduleAmbient(plan.ambientLayers, domainPriorities.ambient));
+    // Music
+    if (plan.musicCue) {
+        commands.push(scheduleMusic(plan.musicCue, domainPriorities.music));
+    }
+    // Sort by timing, then priority (higher first)
+    commands.sort((a, b) => a.timing - b.timing || b.priority - a.priority);
+    return commands;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export type AudioDomain = 'voice' | 'sfx' | 'ambient' | 'music';
+/** A scheduled audio command to be executed by the renderer. */
+export type AudioCommand = {
+    domain: AudioDomain;
+    action: string;
+    resourceId: string;
+    priority: number;
+    timing: number;
+    params: Record<string, unknown>;
+};
+/** Rule for ducking one domain when another plays. */
+export type DuckingRule = {
+    trigger: AudioDomain;
+    target: AudioDomain;
+    duckLevel: number;
+    fadeMs: number;
+};
+/** Tracks cooldown for a resource to prevent spamming. */
+export type CooldownEntry = {
+    resourceId: string;
+    lastPlayedMs: number;
+    cooldownMs: number;
+};
+/** Configuration for the AudioDirector. */
+export type AudioDirectorConfig = {
+    defaultCooldownMs?: number;
+    duckingRules?: DuckingRule[];
+    domainPriorities?: Record<AudioDomain, number>;
+};
+/** Default domain priorities (higher number = higher priority). */
+export declare const DEFAULT_DOMAIN_PRIORITIES: Record<AudioDomain, number>;
+/** Default ducking rules. */
+export declare const DEFAULT_DUCKING_RULES: DuckingRule[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhE,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAKjE,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,qBAAqB,EAAE,WAAW,EAI9C,CAAC"}

package/dist/types.js

@@ -0,0 +1,15 @@
+// Audio director types
+/** Default domain priorities (higher number = higher priority). */
+export const DEFAULT_DOMAIN_PRIORITIES = {
+    voice: 100,
+    sfx: 75,
+    music: 50,
+    ambient: 25,
+};
+/** Default ducking rules. */
+export const DEFAULT_DUCKING_RULES = [
+    { trigger: 'voice', target: 'ambient', duckLevel: 0.3, fadeMs: 300 },
+    { trigger: 'voice', target: 'music', duckLevel: 0.4, fadeMs: 300 },
+    { trigger: 'sfx', target: 'ambient', duckLevel: 0.6, fadeMs: 150 },
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAoCvB,mEAAmE;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAgC;IACpE,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACpE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAClE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CACnE,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@ai-rpg-engine/audio-director",
+  "version": "2.0.0",
+  "description": "Audio cue scheduling, priority, ducking, and cooldown engine for AI RPG Engine",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@ai-rpg-engine/presentation": "^2.0.0"
+  },
+  "license": "MIT",
+  "author": "mcp-tool-shop",
+  "homepage": "https://mcp-tool-shop-org.github.io/ai-rpg-engine/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine.git",
+    "directory": "packages/audio-director"
+  },
+  "keywords": ["rpg", "audio", "director", "sfx", "ambient", "game-engine"],
+  "bugs": {
+    "url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}