Check the connection to Wwise and report the open project.

Report the connected Wwise version and which tools are expected to work on it. Run this first on an untested Wwise version to self-diagnose compatibility.

Run a read-only WAQL query against the open Wwise project.

waql example: '$ from type Event where name : "Footstep"'. Results are capped.

Batch-set a property on objects. Two-step safety: mode='plan' -> returns a ChangeSet + token (no writes); mode='apply' -> pass the token to execute the planned changes.

Read-only project health audit. Checks: 'no_output_bus', 'empty_container', 'empty_sound', 'event_not_in_soundbank', 'duplicate_name' (default: all). Returns counts + a capped findings list.

Flag objects with naming-convention issues (whitespace, non-ASCII, and optionally names not matching pattern, a regex). Read-only.

Cross-check Unity C# event usage against Wwise. Scans .cs files under unity_path for PostEvent("X") string literals and diffs against actual Wwise events: reports events referenced in code but missing in Wwise, and Wwise events never referenced in code. (String-literal calls only; enum IDs not detected.)

Create a Play event '' for target Sounds that lack one (default prefix 'Play_'). Two-step safety: mode='plan' previews + returns a token; mode='apply' with that token creates them (idempotent, undoable). If object_ids is omitted, all Sounds are considered.

Batch-rename objects by a transform (default 'spaces_to_underscores', which fixes whitespace in names). Two-step: mode='plan' previews + returns a token; mode='apply' with that token renames (verified by read-back, undoable).

Count how many objects route to each Output Bus (mix-routing overview). Read-only.

Audit audio sources: flag sources with no original WAV path and original files used by multiple sources. Read-only. (WAAPI does not expose sample rate/channels.)

Add objects (e.g. Events) to a SoundBank's inclusion list (by bank name or id). Two-step: mode='plan' previews + returns a token; mode='apply' with that token writes (idempotent, undoable).

Generate SoundBanks to disk (all banks if soundbanks omitted). Returns a log summary with any error count. This is an action — it writes output, not project data.

Generate a Markdown audio-design doc (project summary, event list, Mermaid bus hierarchy). Returns the markdown; if output_path is given, also writes it there.

Deep-dive one object: all property/reference values, parent, children, and (for Events) action targets. object may be a GUID '{...}', a path '...', or a name.

Wrap objects into a new container (default RandomSequenceContainer) under their parent and move them in. Two-step: mode='plan' previews + returns a token; mode='apply' with that token creates+moves (undoable).

Batch-assign an Attenuation or Conversion ShareSet (by name or id) to objects. reference is 'Attenuation' or 'Conversion'. Two-step plan/apply (undoable).

Reparent objects under a target parent (GUID, path, or name). Two-step plan/apply (idempotent — objects already there are skipped; undoable).

One-shot 'make these sounds playable in-game': conversion → optional container → Play events → output bus → SoundBank, in one call. Always run with dry_run=True first to preview the whole chain, then dry_run=False to execute (each step undoable). Only the stages you pass arguments for run (events always run).

Audit the project and auto-fix the fixable issues: whitespace names (rename), events not in any SoundBank (add to default_bank), sounds with no Output Bus (set default_bus, if given). Issues needing a human (empty sound/container, duplicate name) are reported only. Run dry_run=True first to preview, then dry_run=False to apply.